Google Health API reference

Blood Glucose: the Google Health API blood-glucose 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

Blood Glucose (blood-glucose) is a Sample data type in the Google Health API. Google's data-types table lists list, get, reconcile, rollup and dailyRollup 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 maps the Fitbit Web API's Blood Glucose data to it.

Blood Glucose at a glance

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

Display name: Blood Glucose
dataType (in endpoint URLs): blood-glucose
filter parameter: blood_glucoseGoogle: “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_BLOOD_GLUCOSE
True zeros support: Not marked in Google’s table
Channel: v4
DataPoint field: DataPoint.bloodGlucose → BloodGlucoseIts description: “Optional. Data for points in the blood-glucose sample data type collection.”
Compatible devices: 0 in Google’s table

Operations and request paths

The operations Google’s table lists for blood-glucose, 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 blood-glucose. 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/blood-glucose/dataPoints`
`get`	`get`	`GET https://health.googleapis.com/v4/users/{usersId}/dataTypes/blood-glucose/dataPoints/{dataPointsId}`
`reconcile`	`reconcile`	`GET https://health.googleapis.com/v4/users/{usersId}/dataTypes/blood-glucose/dataPoints:reconcile`
`rollup`	`rollUp`same name, different case	`POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/blood-glucose/dataPoints:rollUp`
`dailyRollup`	`dailyRollUp`same name, different case	`POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/blood-glucose/dataPoints:dailyRollUp`

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

Scopes

The scopes Google’s table lists for blood-glucose, 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 Blood Glucose

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

BloodGlucose — Google: “Represents a blood glucose level measurement. LINT: LEGACY_NAMES”

Field	Type	Google’s description
`bloodGlucoseMilligramsPerDeciliter`Required	`number/double`	Required. Blood glucose level concentration in mg/dL. Must be in the range `[0, 900]`.
`sampleTime`Required	`ObservationSampleTime`	Required. The time at which blood glucose was measured.
`mealType`Optional	`string`	Optional. Meal type of the measurement. `MEAL_TYPE_UNSPECIFIED` — Unspecified meal type. `BREAKFAST` — Breakfast. `LUNCH` — Lunch. `DINNER` — Dinner. `SNACK` — Snack.
`measurementSource`Optional	`string`	Optional. Source of the measurement. `MEASUREMENT_SOURCE_UNSPECIFIED` — Unspecified measurement source. `SELF_MONITORING_BLOOD_GLUCOSE` — Self-monitoring of blood glucose (Blood glucose meter) `CONTINUOUS_GLUCOSE_MONITORING` — Continuous glucose monitoring device `LAB_TEST` — Laboratory test
`measurementTiming`Optional	`string`	Optional. Timing of the measurement. `MEASUREMENT_TIMING_UNSPECIFIED` — Unspecified measurement timing. `AFTER_MEAL` — Measurement taken after meal. `BEFORE_MEAL` — Measurement taken before meal. `FASTING` — Measurement taken while fasting. `GENERAL` — General measurement (not associated with a meal or time of day). `BEFORE_BED` — Measurement taken before bed. `OVER_NIGHT` — Measurement taken over night.
`notes`Optional	`string`	Optional. Standard free-form notes captured at manual logging.
`specimen`Optional	`string`	Optional. Type of body fluid used to measure the blood glucose. `SPECIMEN_UNSPECIFIED` — Unspecified specimen. `CAPILLARY_BLOOD` — Capillary blood. `INTERSTITIAL_FLUID` — Interstitial fluid. `PLASMA` — Plasma. `SERUM` — Serum. `TEARS` — Tears. `WHOLE_BLOOD` — Whole blood.

`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.

Rollup fields

`rollUp` returns `RollupDataPoint.bloodGlucose`

The discovery document: “Returned by default when rolling up data points from the blood-glucose data type.”

BloodGlucoseRollupValue — Google: “Represents the result of the rollup of the blood glucose data type. LINT: LEGACY_NAMES”

Field	Type	Google’s description
`bloodGlucoseMilligramsPerDeciliterAvg`	`number/double`	Average blood glucose level in mg/dL.

`dailyRollUp` returns `DailyRollupDataPoint.bloodGlucose`

The discovery document: “Returned by default when rolling up data points from the blood-glucose data type.”

The same BloodGlucoseRollupValue as the rollUp result above.

Fitbit Web API predecessor

Google’s Fitbit Web API → Google Health API data-type table maps Blood Glucose to blood-glucose.

Fitbit Web API scopes Google maps to blood-glucose’s scopes: blood_glucose, heartrate, oxygen_saturation, respiratory_rate, temperature, weight.

Google’s full Fitbit Web API mapping tables · the migration playbook

Google’s documentation

Related on this site

Blood Glucose API: How to Get Glucose Data Into Your App — 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 blood-glucose 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 blood-glucose. 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 blood glucose data to the Google Health API?

Not according to Google's data-types table, read 2026-10-17: it lists only list, get, reconcile, rollup and dailyRollup for blood-glucose, and no create, update or batchDelete operation.

How do you aggregate blood-glucose data with the Google Health API?

With the rollup methods Google's table lists for it. rollUp (POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/blood-glucose/dataPoints:rollUp) returns RollupDataPoint.bloodGlucose, a BloodGlucoseRollupValue with bloodGlucoseMilligramsPerDeciliterAvg; dailyRollUp (POST https://health.googleapis.com/v4/users/{usersId}/dataTypes/blood-glucose/dataPoints:dailyRollUp) returns DailyRollupDataPoint.bloodGlucose, a BloodGlucoseRollupValue with bloodGlucoseMilligramsPerDeciliterAvg. Each field is described on this page as the discovery document describes it.

What did the Google Health API blood-glucose data type replace in the Fitbit Web API?

Google's Fitbit Web API migration table maps the Fitbit Web API's "Blood Glucose" to blood-glucose. The Fitbit Web API scopes Google maps to its scopes: blood_glucose, heartrate, oxygen_saturation, respiratory_rate, temperature and weight.

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
API specifications — last updated 2026-09-22 · 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