The Google Fit APIs, including the Google Fit REST API, will be deprecated in 2026. As of May 1, 2024, developers cannot sign up to use these APIs.

For instructions on which API or platform to migrate to, visit the Health Connect migration guide. For a comparison of Health Connect with the Google Fit APIs and the Fitbit Web APIs, visit the Health Connect comparison guide.

Learn more about Health Connect and how to integrate with the API.

Nutrition data types

  • Nutrition data includes information about hydration and food consumption.

  • Hydration data points represent the volume of water consumed in a single drink.

  • Nutrition data points detail nutrients consumed as part of a meal or food item, requiring a nutrients field and either a meal type or food item field.

  • Both hydration and nutrition data types have defined names and fields for use with REST and Android interfaces.

  • Specific fields like volume for hydration and meal type, food item, and nutrients for nutrition are detailed with their formats and units.

Data types for nutrition data.

Hydration

Each data point represents how much water a user drank in a single drink.

REST

Name com.google.hydration
OAuth permission scopes
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
Fields (format—units) volume (float—liters)
Volume of water consumed.

Android

Name com.google.hydration
Data type object TYPE_HYDRATION
Fields (format—units) FIELD_VOLUME (float—liters)
Volume of liquid consumed.

Nutrition

Each data point represents what nutrients were consumed as part of a meal or a food item. The data point contains several fields. The nutrients field is required. And either one, or both, of the meal type and food item fields are required.

REST

Name com.google.nutrition
OAuth permission scopes
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
Fields (format—units)
meal type (int—enum) (optional field)
What kind of meal the user ate.
Accepted values

"intVal": 1 // Unknown
"intVal": 2 // Breakfast
"intVal": 3 // Lunch
"intVal": 4 // Dinner
"intVal": 5 // Snack
food item (string—n/a)
The specific food item for the entry. For example, "banana" or "porridge".
nutrients (Map<String>—calories/grams)
The nutritional breakdown of the food item eaten.
Accepted values
"key": "calories" // Calories in kcal
"key": "fat.total" // Total fat in grams
"key": "fat.saturated" // Saturated fat in grams
"key": "fat.unsaturated" // Unsaturated fat in grams
"key": "fat.polyunsaturated" // Polyunsaturated fat in grams
"key": "fat.monounsaturated" // Monounsaturated fat in grams
"key": "fat.trans" // Trans fat in grams
"key": "cholesterol" // Cholesterol in milligrams
"key": "sodium" // Sodium in milligrams
"key": "potassium" // Potassium in milligrams
"key": "carbs.total" // Total carbohydrates in grams
"key": "dietary_fiber" // Dietary fiber in grams
"key": "sugar" // Amount of sugar in grams
"key": "protein" // Protein amount in grams

Android

Name com.google.nutrition
Data type object TYPE_NUTRITION
Fields (format—units)
FIELD_MEAL_TYPE (int—enum) (optional field)
What kind of meal the user ate.
Accepted values

MEAL_TYPE_UNKNOWN // Unknown
MEAL_TYPE_BREAKFAST // Breakfast
MEAL_TYPE_LUNCH // Lunch
MEAL_TYPE_DINNER // Dinner
MEAL_TYPE_SNACK // Snack
FIELD_FOOD_ITEM (string—free-form text)
A description of the food for the entry. For example, "banana" or "porridge".
FIELD_NUTRIENTS (Map<String>—kilocalories/grams/milligrams)
The nutritional breakdown of the food item eaten.
Accepted values
NUTRIENT_CALORIES // Calories in kcal
NUTRIENT_TOTAL_FAT // Total fat in grams
NUTRIENT_SATURATED_FAT // Saturated fat in grams
NUTRIENT_UNSATURATED_FAT // Unsaturated fat in grams
NUTRIENT_POLYUNSATURATED_FAT // Polyunsaturated fat in grams
NUTRIENT_MONOUNSATURATED_FAT // Monounsaturated fat in grams
NUTRIENT_TRANS_FAT // Trans fat in grams
NUTRIENT_CHOLESTEROL // Cholesterol in milligrams
NUTRIENT_SODIUM // Sodium in milligrams
NUTRIENT_POTASSIUM // Potassium in milligrams
NUTRIENT_TOTAL_CARBS // Total carbohydrates in grams
NUTRIENT_DIETARY_FIBER // Dietary fiber in grams
NUTRIENT_SUGAR // Amount of sugar in grams
NUTRIENT_PROTEIN // Protein amount in grams

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. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年08月28日 UTC.