Google Health API reference

Height: the Google Health API height 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

Height (height) is a Sample data type in the Google Health API. Google's data-types table lists list, get, reconcile, create, update and batchDelete for it under the .health_metrics_and_measurements.readonly and .health_metrics_and_measurements.writeonly scopes. The table marks it with webhook support. Google's Fitbit migration table names no Fitbit Web API predecessor for it.

Height at a glance

From the Height row of Google’s data-types table, joined to the discovery document’s DataPoint schema.

Display name: Height
dataType (in endpoint URLs): height
filter parameter: heightGoogle: “The identifier separated by underscores (for example, active_minutes) used as the value for the dataType filter parameter in daily rollup and rollup requests.”
Record type: Sample — Google: “Represents instantaneous measurements.”
Storage resolution: not stated in Google’s table
Webhook support: Yes · automatic-subscription token WEBHOOK_DATA_TYPE_HEIGHT
True zeros support: Not marked in Google’s table
Channel: v4
DataPoint field: DataPoint.height → HeightIts description: “Optional. Data for points in the height sample data type collection.”
Compatible devices: 0 in Google’s table

Operations and request paths

The operations Google’s table lists for height, 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 height. 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/height/dataPoints`
`get`	`get`	`GET https://health.googleapis.com/v4/users/{usersId}/dataTypes/height/dataPoints/{dataPointsId}`
`reconcile`	`reconcile`	`GET https://health.googleapis.com/v4/users/{usersId}/dataTypes/height/dataPoints:reconcile`
`create`	`create`	`POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/height/dataPoints`
`update`	`patch`via Google’s endpoint-mapping table (flagged below)	`PATCH https://health.googleapis.com/v4/users/{usersId}/dataTypes/height/dataPoints/{dataPointsId}`
`batchDelete`	`batchDelete`	`POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/height/dataPoints:batchDelete`

Every method, and how many of the data types list it: the methods overview.

Scopes

The scopes Google’s table lists for height, 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 Height

The schema the discovery document gives DataPoint.height, 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.

Height — Google: “Body height measurement.”

Field	Type	Google’s description
`heightMillimeters`Required	`string/int64`	Required. Height of the user in millimeters. Must be in the range `[0, 3000]`.
`sampleTime`Required	`ObservationSampleTime`	Required. The time at which the height was recorded.

`ObservationSampleTime`

Google: “Represents a sample time of an observed data point.”

Field	Type	Google’s description
`physicalTime`Required	`string/google-datetime`	Required. The time of the observation.
`utcOffset`Required	`string/google-duration`	Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC).
`civilTime`Output only	`CivilDateTime`	Output only. The civil time in the timezone the subject is in at the time of the observation.

Fitbit Web API predecessor

Google’s Fitbit Web API → Google Health API data-type table has no row for height, so it names no Fitbit Web API predecessor.

Fitbit Web API scopes Google maps to height’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.

Operation name differs
The table lists "update" for height, but the discovery document has no method named update; Google's endpoint-mapping table points updates at patch.
- Google's Fitbit migration API specifications: “CREATE & UPDATE Logs”
- Google's Fitbit migration API specifications: “patch method”
- the v4 discovery document: “Updates a single identifiable data point. If a data point with the specified name is not found, the request will fail.”

Google’s documentation

Height in the v4 REST reference

Related on this site

Body Composition API: Weight, Body Fat, and Lean Mass Data — the metric on every platform this site covers, each type quoted in its platform's own words
Google Health API webhooks
Verification and rate limits
The Fitbit Web API turn-off

Questions

Which OAuth scopes does the Google Health API height 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 height. 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 height data to the Google Health API?

Yes. Google's data-types table lists create, update and batchDelete for height. create is POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/height/dataPoints. The table's "update" has no method of that name in the discovery document; Google's endpoint-mapping table points updates at patch, which is PATCH https://health.googleapis.com/v4/users/{usersId}/dataTypes/height/dataPoints/{dataPointsId}. batchDelete is POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/height/dataPoints:batchDelete. Writes need https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly.

How do you aggregate height data with the Google Health API?

Not with rollUp or dailyRollUp, going by Google's data-types table: it lists only list, get, reconcile, create, update and batchDelete for height. Read the data points with list (or reconcile, where listed) and compute any summary yourself.

Does the Google Health API send webhooks for height?

Yes. Google's data-types table marks height with webhook support, the webhooks guide lists it, and automatic subscriptions name it with the token WEBHOOK_DATA_TYPE_HEIGHT.

Other health metrics and measurements data types

All 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 (v4) — 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.

← All Google Health API data types