Food Measurement Unit: the Google Health API food-measurement-unit 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
Food Measurement Unit (food-measurement-unit) is a Food data type in the Google Health API. Google's data-types table lists list and get for it under the .nutrition.readonly and .nutrition.writeonly scopes. The table marks it with neither webhook nor true-zeros support. Google's Fitbit migration table maps the Fitbit Web API's Food Measurement Unit data to it.
Food Measurement Unit at a glance
From the Food Measurement Unit row of Google’s data-types table, joined to the discovery document’s DataPoint schema.
- Display name
- Food Measurement Unit
- dataType (in endpoint URLs)
food-measurement-unit- filter parameter
food_measurement_unitGoogle: “The identifier separated by underscores (for example,active_minutes) used as the value for thedataTypefilter parameter in daily rollup and rollup requests.”- Record type
- Food — Google: “Represents a food item or nutrition-related data entity.”
- 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
- v4
- DataPoint field
DataPoint.foodMeasurementUnit→FoodMeasurementUnitMatched by the kebab-case rule; its description: “Optional. The food measurement unit details.”- Compatible devices
- 16 in Google’s table
Operations and request paths
The operations Google’s table lists for food-measurement-unit, 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 food-measurement-unit. 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/food-measurement-unit/dataPoints |
get | get | GET https://health.googleapis.com/v4/users/{usersId}/dataTypes/food-measurement-unit/dataPoints/{dataPointsId} |
Every method, and how many of the data types list it: the methods overview.
Scopes
The scopes Google’s table lists for food-measurement-unit, 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.nutrition.readonlynot in the v4 discovery document | read | See your Google Health nutrition data. |
https://www.googleapis.com/auth/googlehealth.nutrition.writeonly | write | Add nutrition data to Google Health, and edit or delete the data it adds. |
Fields of Food Measurement Unit
The schema the discovery document gives DataPoint.foodMeasurementUnit, 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.
FoodMeasurementUnit — Google: “Represents a food measurement unit.”
| Field | Type | Google’s description |
|---|---|---|
displayNameRequired | string | Required. The display name of the food measurement unit (e.g., "gram", "piece"). |
pluralDisplayNameOptional | string | Optional. The plural display name of the food measurement unit (e.g., "grams", "pieces"). |
Fitbit Web API predecessor
Google’s Fitbit Web API → Google Health API data-type table maps Food Measurement Unit to food-measurement-unit.
Fitbit Web API scopes Google maps to food-measurement-unit’s scopes: nutrition.
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.
Scope missing from the discovery document
The table lists .nutrition.readonly for food-measurement-unit, but the v4 discovery document defines no https://www.googleapis.com/auth/googlehealth.nutrition.readonly scope, and none of its methods accepts it.
- Google's data-types page: “.nutrition.readonly”
- Google's Scopes page: “See your Google Health nutrition data.”
Compatible devices
The 16 devices Google’s table lists as able to record and sync food-measurement-unit.
- Fitbit Air
- Fitbit Blaze
- Fitbit Charge 2
- Fitbit Charge 3
- Fitbit Charge 4
- Fitbit Ionic
- Pixel Watch
- Pixel Watch 2
- Pixel Watch 3
- Pixel Watch 4
- Fitbit Sense
- Fitbit Sense 2
- Fitbit Versa
- Fitbit Versa 2
- Fitbit Versa 3
- Fitbit Versa 4
Google’s documentation
Related on this site
Questions
Which OAuth scopes does the Google Health API food-measurement-unit data type need?
Google's data-types table (read 2026-10-17) lists https://www.googleapis.com/auth/googlehealth.nutrition.readonly and https://www.googleapis.com/auth/googlehealth.nutrition.writeonly for food-measurement-unit. The Scopes page's consent text: .nutrition.readonly, "See your Google Health nutrition data."; .nutrition.writeonly, "Add nutrition data to Google Health, and edit or delete the data it adds." Note that https://www.googleapis.com/auth/googlehealth.nutrition.readonly is not defined in the v4 discovery document, and none of its methods lists it among accepted scopes.
Can apps write food measurement unit data to the Google Health API?
Not according to Google's data-types table, read 2026-10-17: it lists only list and get for food-measurement-unit, and no create, update or batchDelete operation.
How do you aggregate food-measurement-unit data with the Google Health API?
Not with rollUp or dailyRollUp, going by Google's data-types table: it lists only list and get for food-measurement-unit. Read the data points with list (or reconcile, where listed) and compute any summary yourself.
What did the Google Health API food-measurement-unit data type replace in the Fitbit Web API?
Google's Fitbit Web API migration table maps the Fitbit Web API's "Food Measurement Unit" to food-measurement-unit. The Fitbit Web API scope Google maps to its scopes: nutrition.
Other nutrition 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.