Skin Temperature Sensors: the Google Health API skin-temperature-sensors data type
Read from Google’s documentation on 2026-10-17 · discovery document revision 20261014 · Google’s data-types page last updated 2026-10-06
Skin Temperature Sensors (skin-temperature-sensors) is a Sample data type in the Google Health API, tagged v4beta: Google's preview channel, not the stable v4. Google's data-types table lists list for it under the .health_metrics_and_measurements.readonly and .health_metrics_and_measurements.writeonly scopes. The table marks it with neither webhook nor true-zeros support. Google's Fitbit migration table names no Fitbit Web API predecessor for it.
Skin Temperature Sensors at a glance
From the Skin Temperature Sensors row of Google’s data-types table, joined to the discovery document’s DataPoint schema.
- Display name
- Skin Temperature Sensors
- dataType (in endpoint URLs)
skin-temperature-sensors- filter parameter
skin_temperature_sensorsGoogle: “The identifier separated by underscores (for example,active_minutes) used as the value for thedataTypefilter parameter in daily rollup and rollup requests.”- Record type
- Sample — Google: “Represents instantaneous measurements.”
- Storage resolution
- not stated in Google’s table
- Webhook support
- Not marked in Google’s table
- True zeros support
- Not marked in Google’s table
- Channel
- v4beta (Google’s preview channel)
- DataPoint field
DataPoint.skinTemperatureSensors→SkinTemperatureSensors(v4beta discovery document)Its description: “Optional. Data for points in theskin-temperature-sensorssample data type collection.”- Compatible devices
- 2 in Google’s table
Operations and request paths
The operations Google’s table lists for skin-temperature-sensors, each matched to its users.dataTypes.dataPoints method in the discovery document. The path is the documented path template (the method’s flatPath on https://health.googleapis.com/) with {dataTypesId} filled in as skin-temperature-sensors. Google on {user}: “The {user} can be either the alias me or the authenticated user's numeric Health User ID (retrieved via GetIdentity).”
| Table lists | Method | Documented path template |
|---|---|---|
list | list | GET https://health.googleapis.com/v4/users/{usersId}/dataTypes/skin-temperature-sensors/dataPoints |
Every method, and how many of the data types list it: the methods overview.
Scopes
The scopes Google’s table lists for skin-temperature-sensors, as full URLs, with the consent text Google’s Scopes page gives each. Every Google Health API scope.
| Scope | Access | Google’s permission text |
|---|---|---|
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly | read | See your Google Health health metrics and measurement data. |
https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly | write | Add health metric and measurements data to Google Health, and edit or delete the data it adds. |
Fields of Skin Temperature Sensors
The schema the discovery document gives DataPoint.skinTemperatureSensors, required fields first. Types are as the discovery document states them; the label is the word Google’s description opens with. The schemas its fields refer to follow, one level deep.
SkinTemperatureSensors — Google: “Skin temperature sensor data containing multi-sensor readings.”
| Field | Type | Google’s description |
|---|---|---|
sampleTimeRequired | ObservationSampleTime | Required. The observation sample time. |
sensorDataRequired | array<SensorData> | Required. Repeated sensor data readings for this sample. |
ObservationSampleTime
Google: “Represents a sample time of an observed data point.”
| Field | Type | Google’s description |
|---|---|---|
physicalTimeRequired | string/google-datetime | Required. The time of the observation. |
utcOffsetRequired | string/google-duration | Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). |
civilTimeOutput only | CivilDateTime | Output only. The civil time in the timezone the subject is in at the time of the observation. |
SensorData
Google: “Individual sensor reading and metadata.”
| Field | Type | Google’s description |
|---|---|---|
temperatureCelsiusRequired | number/double | Required. The temperature reading in Celsius. |
metadataOptional | SensorMetadata | Optional. Metadata for the sensor reading. |
Fitbit Web API predecessor
Google’s Fitbit Web API → Google Health API data-type table has no row for skin-temperature-sensors, so it names no Fitbit Web API predecessor.
Fitbit Web API scopes Google maps to skin-temperature-sensors’s scopes: blood_glucose, heartrate, oxygen_saturation, respiratory_rate, temperature, weight.
Google’s full Fitbit Web API mapping tables · the migration playbook
Where Google’s pages disagree
Published as found, with the texts that disagree; nothing here is corrected by us.
No v4 DataPoint field
The v4 discovery document has no DataPoint property for skin-temperature-sensors; the v4beta document has skinTemperatureSensors, matching the table's v4beta tag.
- Google's data-types page: “Skin Temperature Sensors”
- Google's data-types page: “list”
- the v4beta discovery document: “Optional. Data for points in the
skin-temperature-sensorssample data type collection.”
Compatible devices
The 2 devices Google’s table lists as able to record and sync skin-temperature-sensors.
- Pixel Watch 4
- Pixel Watch 5
Google’s documentation
Related on this site
- Body Temperature API: Core, Skin and Wrist Temperature Data — the metric on every platform this site covers, each type quoted in its platform's own words
- Verification and rate limits
- The Fitbit Web API turn-off
Questions
Which OAuth scopes does the Google Health API skin-temperature-sensors data type need?
Google's data-types table (read 2026-10-17) lists https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly and https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly for skin-temperature-sensors. The Scopes page's consent text: .health_metrics_and_measurements.readonly, "See your Google Health health metrics and measurement data."; .health_metrics_and_measurements.writeonly, "Add health metric and measurements data to Google Health, and edit or delete the data it adds."
Can apps write skin temperature sensors data to the Google Health API?
Not according to Google's data-types table, read 2026-10-17: it lists only list for skin-temperature-sensors, and no create, update or batchDelete operation.
How do you aggregate skin-temperature-sensors data with the Google Health API?
Not with rollUp or dailyRollUp, going by Google's data-types table: it lists only list for skin-temperature-sensors. Read the data points with list (or reconcile, where listed) and compute any summary yourself.
Does the Google Health API send webhooks for skin-temperature-sensors?
Not according to Google's data-types table, which does not mark skin-temperature-sensors with webhook support, and the webhooks guide does not list it.
Other health metrics and measurements data types
Sources checked
- Google Health API data types — last updated 2026-10-06 · read 2026-10-17
- Google Health API discovery document (v4beta) — revision 20261014 · read 2026-10-17
- Scopes — last updated 2026-10-09 · read 2026-10-17
Google’s text is quoted for identification; each guide page’s footer reads: “Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License.”. Generated from Google’s pages by scripts/fetch-google-health-api.mjs, not typed by hand; Google’s documentation remains the authority.