Las APIs de Google Fit, incluida la API de REST de Google Fit, dejarán de estar disponibles después del 30 de junio de 2025. A partir del 1 de mayo de 2024, los desarrolladores no pueden registrarse para usar estas APIs.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En el caso de los datos que se pueden registrar de forma continua (con varios datos durante un período), la plataforma de Google Fit puede agregar estos datos y mostrar los resultados calculados. Puede ser una medición promedio o un resumen/total. Puedes ahorrar tiempo en estos cálculos y leer los datos agregados para mostrarles a los usuarios de tu app promedios o resúmenes útiles.
Para leer datos agregados, debes elegir un tipo de datos, un intervalo de tiempo y un elemento para “agrupar” (o agrupar) los datos. Puedes agrupar los datos de diferentes maneras:
Período
Agrupa datos agregados por hora o por día. Por ejemplo, puede consultar los pasos o las calorías quemadas por día.
Tipo de actividad
Agrupa datos agregados por tipo de actividad. Por ejemplo, en el caso de los datos de sueño correspondientes a una semana, habrá un bucket para cada tipo de actividad de sueño (ligero, profundo y REM).
Segmento de actividad
Agrupa datos agregados por segmentos de actividad durante un período. Por ejemplo, si un usuario salió a correr entre las 9 a.m. y las 10 a.m., pero corrió los primeros 20 minutos, se sentó por 10 minutos, caminó por 15 minutos y corrió durante 15 minutos, estos datos se consideran 4 segmentos de actividad y mostrarían 4 buckets.
Sesión
Usa los límites de tiempo de las sesiones para agregar datos. Por ejemplo, si un usuario realizó 2 ejecuciones que se registraron como 2 sesiones (una carrera por la mañana y una por la tarde), puedes agrupar por sesión para conocer los pasos o la velocidad promedio de cada ejecución.
Actividad
Usa estos tipos de datos para leer los datos agregados de salud y bienestar.
Resumen de actividades
Indica el tiempo total y la cantidad de segmentos para una actividad en particular durante un período.
Cada dato representa un resumen de todos los segmentos de actividad para un tipo de actividad en particular durante un intervalo de tiempo.
El tipo de actividad que estaba realizando el usuario. Consulta la lista de tipos de actividad aquí.
duration (int—milisegundos)
Tiempo total dedicado a una actividad en todos los segmentos del intervalo de tiempo.
cantidad de segmentos (int; recuento)
La cantidad de segmentos de actividad distintos durante el intervalo de tiempo de estos datos.
Android
Nombre
com.google.activity.summary
Objeto de tipo de datos
AGGREGATE_ACTIVITY_SUMMARY
Campos (formato: unidades)
FIELD_ACTIVITY (int-enumeración)
El tipo de actividad que estaba realizando el usuario. Consulta la lista de tipos de actividad aquí.
FIELD_DURATION (int—milisegundos)
Tiempo total dedicado a una actividad en todos los segmentos del intervalo de tiempo.
FIELD_NUM_SEGMENTS (int, cantidad)
La cantidad de segmentos de actividad distintos durante el intervalo de tiempo de estos datos.
Resumen de la tasa metabólica basal (TMB)
Cada dato representa la tasa metabólica basal promedio, máxima y mínima del usuario durante el intervalo de tiempo, en kilocalorías por día. Esto es útil si el usuario aumentó o perdió peso y, por lo tanto, cambió su TMB.
Indica la TMB promedio del usuario durante un período.
máx. (float-kcal por día)
Es la TMB máximo del usuario durante un período.
min (float-kcal por día)
Indica la TMB mínimo del usuario durante un período.
Android
Nombre
com.google.calories.bmr.summary
Objeto de tipo de datos
AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
Campos (formato: unidades)
FIELD_AVERAGE (float a kcal por día)
Indica la TMB promedio del usuario durante un período.
FIELD_MAX (float-kcal por día)
Es la TMB máximo del usuario durante un período.
FIELD_MIN (float a kcal por día)
Indica la TMB mínimo del usuario durante un período.
Resumen de calorías quemadas
Es el total o el total de calorías quemadas, en kilocalorías, durante un período.
Este tipo de datos y sus campos son los mismos que para el tipo de datos instantáneos.
Resumen de Puntos cardio
Cada dato representa la cantidad de Puntos cardio obtenidos durante el período.
La cantidad de Puntos cardio obtenidos durante el período, incluidos los puntos obtenidos por multiplicadores (más puntos ganados por actividad más extenuante).
duration (float—minutos)
El tiempo en que se obtuvieron los Puntos cardio, medido en minutos.
Android
Nombre
com.google.heart_minutes.summary
Objeto de tipo de datos
AGGREGATE_HEART_POINTS
Campos (formato: unidades)
FIELD_INTENSITY (float—Puntos cardio)
La cantidad de Puntos cardio obtenidos durante el período, incluidos los puntos obtenidos por multiplicadores (más puntos ganados por actividad más extenuante).
FIELD_DURATION (float minutos)
El tiempo en que se obtuvieron los Puntos cardio, medido en minutos.
Resumen de Minutos de actividad
La cantidad total de minutos de actividad durante el período. Este tipo de datos y los campos son los mismos que para el tipo de datos instantáneos.
Resumen de energía
Cada dato representa la potencia promedio, máxima y mínima del usuario generada en vatios, durante un período de tiempo.
Potencia promedio del usuario generada durante el período, en vatios.
máx. (float—vatios)
Potencia máxima del usuario generada durante el período, en vatios.
min (float: vatios)
Potencia mínima del usuario generada durante el período, en vatios.
Android
Nombre
com.google.power.summary
Objeto de tipo de datos
AGGREGATE_POWER_SUMMARY
Campos (formato: unidades)
FIELD_AVERAGE (float—vatios)
Potencia promedio del usuario generada durante el período, en vatios.
FIELD_MAX (float—vatios)
Potencia máxima del usuario generada durante el período, en vatios.
FIELD_MIN (float-vatios)
Potencia mínima del usuario generada durante el período, en vatios.
Resumen delta del recuento de pasos
Cada dato representa el número total de pasos durante el período.
Este tipo de datos y sus campos son los mismos que para el tipo de datos instantáneos.
Cuerpo
Utiliza estos tipos de datos para leer datos agregados de mediciones corporales.
Resumen del porcentaje de grasa corporal
Cada dato representa el porcentaje promedio, máximo y mínimo de grasa corporal del usuario durante un período.
REST
Nombre
com.google.body.fat.percentage.summary
Alcances de los permisos de OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (formato: unidades)
promedio (float: porcentaje)
Porcentaje promedio del usuario de la masa corporal total que es grasa corporal durante un período.
max (float: por ciento)
Porcentaje máximo del usuario de la masa corporal total que es grasa corporal durante un período.
min (float: por ciento)
Porcentaje mínimo del usuario de la masa corporal total que es grasa corporal durante un período.
Android
Nombre
com.google.body.fat.percentage.summary
Objeto de tipo de datos
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Campos (formato: unidades)
FIELD_AVERAGE (float: por ciento)
Porcentaje promedio del usuario de la masa corporal total que es grasa corporal durante un período.
FIELD_MAX (float: por ciento)
Porcentaje máximo del usuario de la masa corporal total que es grasa corporal durante un período.
FIELD_MIN (float: por ciento)
Porcentaje mínimo del usuario de la masa corporal total que es grasa corporal durante un período.
Resumen de la frecuencia cardíaca
Cada dato representa la frecuencia cardíaca promedio, máxima y mínima del usuario durante un período, en pulsaciones por minuto.
REST
Nombre
com.google.heart_rate.summary
Alcances de los permisos de OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (formato: unidades)
promedio (float-ppm)
La frecuencia cardíaca promedio del usuario en pulsaciones por minuto durante un período.
max (float-ppm)
Indica la frecuencia cardíaca máxima del usuario en pulsaciones por minuto durante un período.
min (float-ppm)
La frecuencia cardíaca mínima del usuario en pulsaciones por minuto, durante un período.
Android
Nombre
com.google.heart_rate.summary
Objeto de tipo de datos
AGGREGATE_HEART_RATE_SUMMARY
Campos (formato: unidades)
FIELD_AVERAGE (float-ppm)
La frecuencia cardíaca promedio del usuario en pulsaciones por minuto durante un período.
FIELD_MAX (float-ppm)
Indica la frecuencia cardíaca máxima del usuario en pulsaciones por minuto durante un período.
FIELD_MIN (float-ppm)
La frecuencia cardíaca mínima del usuario en pulsaciones por minuto, durante un período.
Resumen de altura
Cada dato representa la altura promedio, máxima y mínima del usuario durante un período, en metros.
REST
Nombre
com.google.height.summary
Alcances de los permisos de OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (formato: unidades)
promedio (float—metros)
Altura promedio del usuario durante un período, en metros.
max (float—metros)
Altura máxima del usuario durante un período, en metros.
min (float—metros)
La altura mínima del usuario durante un período, en metros.
Android
Nombre
com.google.height.summary
Objeto de tipo de datos
AGGREGATE_HEIGHT_SUMMARY
Campos (formato: unidades)
FIELD_AVERAGE (float—metros)
Altura promedio del usuario durante un período, en metros.
FIELD_MAX (float—metros)
Altura máxima del usuario durante un período, en metros.
FIELD_MIN (float—metros)
La altura mínima del usuario durante un período, en metros.
Resumen de peso
Cada dato representa el peso promedio, máximo y mínimo del usuario durante un período, en kilogramos.
REST
Nombre
com.google.weight.summary
Alcances de los permisos de OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (formato: unidades)
promedio (float-kg)
El peso corporal promedio del usuario durante un período, en kilogramos
máx. (float-kg)
El peso corporal máximo del usuario durante un período, en kilogramos.
min (float-kg)
El peso corporal mínimo del usuario durante un período, en kilogramos.
Android
Nombre
com.google.weight.summary
Objeto de tipo de datos
AGGREGATE_WEIGHT_SUMMARY
Campos (formato: unidades)
FIELD_AVERAGE (de float a kg)
El peso corporal promedio del usuario durante un período, en kilogramos
FIELD_MAX (float-kg)
El peso corporal máximo del usuario durante un período, en kilogramos.
FIELD_MIN (de float a kg)
El peso corporal mínimo del usuario durante un período, en kilogramos.
Ubicación
Usa estos tipos de datos para leer datos de ubicación agregados.
Distancia delta
Cada dato representa la distancia total recorrida por el usuario durante un período, en metros. Este tipo de datos y sus campos son los mismos que para el tipo de datos instantáneos.
Cuadro de límite de la ubicación
Cada dato representa el cuadro de límite calculado sobre los puntos de ubicación del usuario durante un período. Cada cuadro delimitador tiene cuatro campos
que representan las cuatro esquinas del cuadro.
La velocidad promedio del usuario durante un período, en metros por segundo.
max (float: metros por segundo)
La velocidad máxima del usuario durante un período, en metros por segundo.
min (float: metros por segundo)
La velocidad mínima del usuario durante un período, en metros por segundo.
Android
Nombre
com.google.speed.summary
Objeto de tipo de datos
AGGREGATE_SPEED_SUMMARY
Campos (formato: unidades)
promedio (float: metros por segundo)
La velocidad promedio del usuario durante un período, en metros por segundo.
max (float: metros por segundo)
La velocidad máxima del usuario durante un período, en metros por segundo.
min (float: metros por segundo)
La velocidad mínima del usuario durante un período, en metros por segundo.
Nutrición
Usa estos tipos de datos para leer los datos de nutrición agregados.
Resumen de hidratación
Cada dato representa el volumen total de agua que consumió un usuario durante un período, en litros. Este tipo de datos y sus campos son los mismos que para el tipo de datos instantáneos.
Resumen nutricional
Cada dato representa la suma de todas las entradas de nutrición durante un período de tiempo.
En el campo de nutrientes, cada valor representa la suma de los nutrientes en todas las entradas del período.
Si el nutriente no estaba en ninguna de las entradas, tampoco estará en el mapa agregado. Si todas las entradas en el período son para la misma comida, también se establecerá el tipo de comida.
Cantidad total de nutrientes ingeridos en la comida durante un período.
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
Nombre
com.google.nutrition.summary
Objeto de tipo de datos
AGGREGATE_NUTRITION_SUMMARY
Campos (formato: unidades)
FIELD_MEAL_TYPE (int-enumeración)
El tipo de comida que comió el usuario (presente si todas las entradas en el período son para la misma comida)
Cantidad total de nutrientes ingeridos en la comida durante un período.
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
Estado
Usa estos tipos de datos para leer datos médicos y de salud agregados.
Resumen de glucemia
Cada dato representa la concentración o el nivel de glucemia promedio, mínimo y máximo durante el intervalo de tiempo, medido en mmol/l, en el que 1 mmol/L equivale a 18 mg/dL.
Si los valores de cada uno de estos campos son los mismos para todas las mediciones realizadas durante el intervalo de tiempo, verás el valor del campo en los datos mostrados:
relación temporal con una comida
relación temporal con el sueño
fuente del modelo
Si los valores son diferentes en todas las mediciones, se excluirá el campo.
La concentración o nivel promedio de glucemia del usuario durante un período.
máx. (float-mmol/L)
La concentración o el nivel máximo de glucemia del usuario durante un período
min (float-mmol/L)
La concentración o el nivel mínimo de glucemia del usuario durante un período
relación temporal con comida (int—enumeración) (campo opcional)
Cuándo se realizó la medición en comparación con la hora en que el usuario comió.
Accepted values
"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal
tipo de comida (int—enumeración) (campo opcional)
Indica qué tipo de comida comió el usuario cuando se realizó la medición.
relación temporal con sleep (int: enumeración) (campo opcional)
El momento en que se realizó la medición en comparación con el momento en que el usuario durmió.
Accepted values
"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping
Cuándo se realizó la medición en comparación con la hora en que el usuario comió.
Accepted values
FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal
El momento en que se realizó la medición en comparación con el momento en que el usuario durmió.
Accepted values
TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.
Cada dato representa la presión arterial promedio, mínima y máxima durante el intervalo de tiempo, medida en mmHg.
Si los valores de cada uno de estos campos son los mismos para todas las mediciones realizadas durante el intervalo de tiempo, verás el valor del campo en los datos mostrados:
posición del cuerpo
ubicación de medición
Si los valores son diferentes en todas las mediciones, se excluirá el campo.
Es la posición del cuerpo del usuario cuando se realizó la medición.
Accepted values
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
En qué brazo y parte del brazo se realizó la medición.
Accepted values
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm
Resumen de temperatura corporal
Cada dato representa la temperatura corporal promedio, mínima y máxima del usuario en un intervalo de tiempo.
También tendrá la ubicación en el cuerpo donde se realizó la medición si la ubicación de medición es la misma para todos los datos del intervalo de tiempo.
Cada dato representa la saturación promedio, mínima y máxima de oxígeno en sangre y la tasa de flujo de oxígeno complementario del usuario durante un intervalo de tiempo.
Si los valores de cada uno de estos campos son los mismos para todas las mediciones realizadas durante el intervalo de tiempo, verás el valor del campo en los datos mostrados:
modo de administración de la terapia de oxígeno
sistema de saturación de oxígeno
método de medición de saturación de oxígeno
Si los valores son diferentes en todas las mediciones, se excluirá el campo.