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.
Para los datos que pueden registrarse de forma continua (con varios datos en un período
período), la plataforma de Google Fit puede agregar estos datos y mostrar la
resultados calculados. Puede ser una medición promedio o un resumen/total. Tú
puede ahorrar tiempo en estos cálculos y mostrarles a los usuarios resúmenes útiles o
y los promedios fácilmente leyendo los datos agregados.
Para leer datos agregados, debes elegir un tipo de datos, un intervalo de tiempo y algo
al “bucket” (o agrupar) los datos. Existen varias maneras de agrupar datos:
Período
Agrupar datos agregados por hora o por día Por ejemplo, consulta los pasos o las calorías quemadas al día.
Tipo de actividad
Agrupar datos agregados por tipo de actividad Por ejemplo, en el caso de los datos de sueño de una semana, habrá un bucket para cada tipo de actividad de sueño (ligera, profunda y REM).
Segmento de actividad
Agrupar los datos agregados en función de los segmentos de actividad durante un período determinado Por ejemplo, si un usuario corrió entre las 9 a.m. y las 10 a.m., pero corrió durante los primeros 20 minutos, se sentó durante 10 minutos, caminó durante 15 minutos y corrió durante 15 minutos, estos se consideran 4 segmentos de actividad y se mostrarán 4 buckets.
Sesión
Usa los límites de tiempo de las sesiones para agregar datos. Por ejemplo, si un usuario realizó 2 carreras 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 promedio o la velocidad promedio de cada carrera.
Actividad
Usa estos tipos de datos para leer datos agregados de salud y bienestar.
Resumen de actividades
Indica el tiempo total y la cantidad de segmentos de una actividad en particular durante un período.
Cada dato representa un resumen de todos los segmentos de actividad para un evento en particular
tipo de actividad durante un intervalo de tiempo.
Es el tiempo total dedicado a una actividad en todos los segmentos del intervalo de tiempo.
FIELD_NUM_SEGMENTS (cantidad: int)
La cantidad de segmentos de actividad distintos durante el intervalo de tiempo de este dato.
Resumen de la tasa metabólica basal (BMR)
Cada dato representa la tasa metabólica basal promedio, máxima y mínima del usuario
a lo largo del intervalo de tiempo, en kilocalorías por día. Esto es útil si el usuario tiene
ganaron o perdieron peso y, por lo tanto, su tasa de medición cardiaca ha cambiado.
Tasa de crecimiento meta meta (BMR) promedio del usuario durante un período.
max (float-kcal por día)
Corresponde al valor de BMR máximo del usuario durante un período.
min (float-kcal por día)
Corresponde al valor de BMR del usuario como mínimo 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-kcal por día)
Tasa de crecimiento meta meta (BMR) promedio del usuario durante un período.
FIELD_MAX (float-kcal por día)
Corresponde al valor de BMR máximo del usuario durante un período.
FIELD_MIN (float-kcal por día)
Corresponde al valor de BMR del usuario como mínimo durante un período.
Resumen de calorías quemadas
Es el total o agregado de calorías quemadas, en kilocalorías, durante un período.
Este tipo de datos y sus campos son los mismos que para los datos instantáneos
del tipo de fila.
Resumen de Puntos cardio
Cada dato representa la cantidad de Puntos cardio obtenidos durante el período.
La potencia promedio del usuario generada a lo largo del período, en vatios.
max (float: vatios)
La potencia máxima del usuario generada a lo largo del período, en vatios.
min (float: vatios)
La potencia mínima del usuario generada a lo largo del 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)
La potencia promedio del usuario generada a lo largo del período, en vatios.
FIELD_MAX (float—vatios)
La potencia máxima del usuario generada a lo largo del período, en vatios.
FIELD_MIN (float—vatios)
La potencia mínima del usuario generada a lo largo del período, en vatios.
Resumen del recuento de pasos
Cada dato representa la cantidad total de pasos durante el período.
Este tipo de datos y sus campos son los mismos que para los datos instantáneos
del tipo de fila.
Cuerpo
Usa estos tipos de datos para leer los datos agregados de medición corporal.
Resumen del porcentaje de grasa corporal
Cada dato representa el porcentaje de grasa corporal promedio, máximo y mínimo del usuario
durante un período.
REST
Nombre
com.google.body.fat.percentage.summary
Permisos de OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (formato: unidades)
promedio (float-por ciento)
Porcentaje promedio del usuario de la masa corporal total que es grasa corporal durante un período de tiempo
max (float-por ciento)
Porcentaje máximo del usuario de la masa corporal total que es grasa corporal durante un período.
min (float: porcentaje)
Porcentaje mínimo del usuario de la masa corporal total que es grasa corporal durante un período de tiempo.
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 de tiempo
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 de tiempo.
Resumen de la frecuencia cardíaca
Cada dato representa la frecuencia cardíaca promedio, máxima y mínima del usuario durante el
de tiempo, en pulsaciones por minuto.
REST
Nombre
com.google.heart_rate.summary
Permisos de OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (formato: unidades)
promedio (float-ppm)
Frecuencia cardíaca promedio del usuario en pulsaciones por minuto, durante un período.
max (float-ppm)
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)
Frecuencia cardíaca promedio del usuario en pulsaciones por minuto, durante un período.
FIELD_MAX (float-ppm)
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 alturas
Cada dato representa la altura promedio, máxima y mínima del usuario durante un período determinado.
en metros, en metros.
REST
Nombre
com.google.height.summary
Permisos de OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (formato: unidades)
average (float: metros)
La altura promedio del usuario durante un período, en metros.
max (float: metros)
La 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)
La altura promedio del usuario durante un período, en metros.
FIELD_MAX (float: metros)
La 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 del peso
Cada dato representa el peso promedio, máximo y mínimo del usuario durante un
período de tiempo, en kilogramos.
REST
Nombre
com.google.weight.summary
Permisos de OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (formato: unidades)
promedio (float-kg)
Indica 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 (float-kg)
Indica 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 (float-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 a lo largo de un tiempo
en metros, en metros. Este tipo de datos y sus campos son los mismos que para el
tipo de datos instantáneos.
Cuadro delimitador de ubicación
Cada dato representa el límite
cuadro calculado sobre la capa
puntos de ubicación durante un período. Cada cuadro delimitador tiene cuatro campos.
que representan las cuatro esquinas del cuadro delimitador.
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 nutricionales agregados.
Resumen de hidratación
Cada dato representa el volumen total de agua consumido por un usuario durante un período
de tiempo de espera, 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.
En el campo de nutrientes, cada valor representa la suma total de los nutrientes
de las entradas en el período.
Si el nutriente no estaba en ninguna de las entradas, no aparecerá en el mapa agregado
cualquiera de las dos opciones. Si todas las entradas del período corresponden a la misma comida, el tipo de comida
también se establecerá la configuración.
El total de nutrientes ingeridos en los alimentos durante un período.
Valores aceptados
"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 del período corresponden a la misma comida)
El total de nutrientes ingeridos en los alimentos durante un período.
Valores aceptados
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
Salud
Usa estos tipos de datos para leer datos médicos y de salud agregados.
Resumen de glucemia
Cada dato representa el nivel de glucemia promedio, mínimo y máximo
o la concentración durante el intervalo de tiempo, medido en mmol/L, donde 1 mmol/L es 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 devueltos:
relación temporal con una comida
relación temporal con el sueño
fuente del espécimen
Si los valores son diferentes en las mediciones, se excluirá el campo.
Indica la concentración o el nivel de glucemia promedio del usuario durante un período.
max (float-mmol/L)
Indica la concentración o el nivel máximo de glucemia del usuario durante un período.
min (float-mmol/L)
Indica la concentración o el nivel mínimo de glucemia del usuario durante un período.
relación temporal con la comida (int: enumeración) (campo opcional)
Cuándo se realizó la medición y cuándo el usuario comió.
Valores aceptados
"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
meal type (int: enumeración) (campo opcional)
Qué tipo de comida comió el usuario cuando se realizó la medición.
Cuándo se realizó la medición y cuándo el usuario comió.
Valores aceptados
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
Cuándo se realizó la medición en comparación con cuándo durmió el usuario.
Valores aceptados
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, medido 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 devueltos:
posición del cuerpo
ubicación de la medición
Si los valores son diferentes en las mediciones, se excluirá el campo.
La posición del cuerpo del usuario cuando se realizó la medición.
Valores aceptados
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
De qué brazo y parte del brazo se realizó la medición
Valores aceptados
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 de
al usuario durante un intervalo de tiempo.
También tendrá la ubicación del cuerpo en la que se realizó la medición, si la
la ubicación de medición fue la misma para todos los datos del intervalo de tiempo.
Cada dato representa el nivel de oxígeno en sangre promedio, mínimo y máximo
la saturación y la tasa de flujo de oxígeno complementario del usuario en 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 devueltos:
modo de administración de la oxigenoterapia
sistema de saturación de oxígeno
método de medición de la saturación de oxígeno
Si los valores son diferentes en las mediciones, se excluirá el campo.
[null,null,["Última actualización: 2024-08-22 (UTC)"],[[["Google Fit provides aggregate data types for efficient retrieval of calculated summaries like steps, calories, heart rate, and more."],["Data is read by specifying a data type, time range, and grouping method (time period, activity type, segment, or session)."],["Data types are categorized into Activity, Body, Location, Speed, Nutrition and Health, each with specific fields and units."],["Access to certain data types requires OAuth permission scopes."],["The document outlines REST and Android specifications for body temperature, blood pressure, and oxygen saturation data, including fields, units, and OAuth permissions."]]],[]]
