Tipos de datos de la API de Google Health

En la siguiente tabla, se incluye la lista completa de tipos de datos, con varias columnas para ayudarte a comprender la representación de cada tipo en la API de Google Health, así como el alcance en el que está disponible cada uno.

Importante: El formato de los identificadores de tipo de datos difiere cuando el tipo de datos tiene más de una palabra. En un extremo, el nombre del tipo de datos debe estar en kebab case, como body-fat. Sin embargo, en un parámetro de filtro, el nombre del tipo de datos debe estar en formato snake_case, como body_fat.

Tabla: Tipos de datos de la API de Google Health

Tipo de datos   dataType Parámetro   filter	Record type	Operaciones disponibles	Alcance	Compatibilidad con webhook	Compatibilidad con True zeros
Gasto calórico activo   active-energy-burned   active_energy_burned	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Minutos activos   active-minutes   active_minutes	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Minutos en zona activa   active-zone-minutes   active_zone_minutes	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Nivel de actividad   activity-level   activity_level	Intervalo	lista, reconciliar	activity_and_fitness
Altitud   altitude   altitude	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Glucemia   blood-glucose   blood_glucose	Muestra	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Grasa corporal   body-fat   body_fat	Muestra	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
Calorías en la zona de frecuencia cardíaca   calories-in-heart-rate-zone   calories_in_heart_rate_zone	Intervalo	acumulado, dailyRollup	activity_and_fitness
Temperatura corporal central   core-body-temperature   core_body_temperature	Muestra	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Variabilidad del ritmo cardíaco diaria   daily-heart-rate-variability   daily_heart_rate_variability	Diario	lista, reconciliar	health_metrics_and_measurements
Zonas de frecuencia cardíaca diarias   daily-heart-rate-zones   daily_heart_rate_zones	Diario	lista, reconciliar	health_metrics_and_measurements
Saturación de oxígeno diaria   daily-oxygen-saturation   daily_oxygen_saturation	Diario	lista, reconciliar	health_metrics_and_measurements
Frecuencia respiratoria diaria   daily-respiratory-rate   daily_respiratory_rate	Diario	lista, reconciliar	health_metrics_and_measurements
Frecuencia cardíaca en reposo diaria   daily-resting-heart-rate   daily_resting_heart_rate	Diario	lista, reconciliar	health_metrics_and_measurements
Derivaciones diarias de la temperatura del sueño   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	Diario	lista, reconciliar	health_metrics_and_measurements
VO2 máx. diario   daily-vo2-max   daily_vo2_max	Diario	lista, reconciliar	activity_and_fitness
Distancia   distance   distance	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Electrocardiograma (ECG)   electrocardiogram   electrocardiogram	Sesión	list	ecg
Ejercicio   exercise   exercise	Sesión	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Pisos   floors   floors	Intervalo	reconcile, rollup, dailyRollup	activity_and_fitness
Comida   food   food	Comida	list, get	nutrición
Unidad de medida de alimentos   food-measurement-unit   food_measurement_unit	Comida	list, get	nutrición
Frecuencia cardíaca   heart-rate   heart_rate	Muestra	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Variabilidad del ritmo cardíaco   heart-rate-variability   heart_rate_variability	Muestra	lista, reconciliar	health_metrics_and_measurements
Altura   height   height	Muestra	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
Registro de hidratación   hydration-log   hydration_log	Sesión	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrición
Notificación de arritmias   irregular-rhythm-notification   irregular_rhythm_notification	Sesión	list	irn
Registro de nutrición   nutrition-log   nutrition_log	Muestra	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrición
Saturación de oxígeno   oxygen-saturation   oxygen_saturation	Muestra	lista, reconciliar	health_metrics_and_measurements
Resumen de sueño de la frecuencia respiratoria   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Muestra	lista, reconciliar	health_metrics_and_measurements
VO2 máx. en carreras   run-vo2-max   run_vo2_max	Muestra	list, reconcile, rollup, dailyRollup	activity_and_fitness
Período sedentario   sedentary-period   sedentary_period	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Sueño   sleep   sleep	Sesión	list, get, reconcile, create, update, batchDelete	sueño
Pasos   steps   steps	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Datos de largos de natación   swim-lengths-data   swim_lengths_data	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Tiempo en la zona de frecuencia cardíaca   time-in-heart-rate-zone   time_in_heart_rate_zone	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Calorías totales   total-calories   total_calories	Intervalo	acumulado, dailyRollup	activity_and_fitness
VO2 máx.   vo2-max   vo2_max	Muestra	lista, reconciliar	activity_and_fitness
Peso   weight   weight	Muestra	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

Restricciones de la búsqueda

Cuando consultes puntos de datos, resúmenes o resúmenes diarios desde la API, ten en cuenta las siguientes restricciones:

• Requisitos de filtro: Algunos tipos de datos derivados de solo lectura, como total-calories, requieren un filtro que especifique la hora de inicio de un intervalo (con hora física o civil).
• Límites del período de la consulta: El período máximo de la consulta para calories-in-heart-rate-zone, heart-rate, active-minutes y total-calories es de 14 días. El intervalo máximo de la consulta para todos los demás tipos de datos es de 90 días.

Disponibilidad de los datos

Las actualizaciones de los datos del usuario solo están disponibles después de que sincroniza su monitor de actividad o ingresa manualmente datos nuevos en la app de Fitbit para dispositivos móviles o en la app web. El dispositivo Fitbit y la app de Fitbit para dispositivos móviles se pueden sincronizar automáticamente cada 15 minutos cuando la app de Fitbit está abierta en el dispositivo móvil y ambos tienen una conexión de datos activa y están dentro del alcance de Bluetooth. Si el usuario hace un seguimiento de la actividad con MobileTrack, este se sincroniza cada hora siempre que la app esté abierta.

Acceso de terceros

Los dispositivos Fitbit no pueden comunicarse directamente con aplicaciones o servicios de terceros. Estos dispositivos están diseñados para comunicarse y sincronizarse exclusivamente con la app de Fitbit para dispositivos móviles.

El dispositivo sincroniza los datos automáticamente durante el día, cada vez que se abre la app de Fitbit o cada 15 minutos si el Bluetooth está activo y la app se ejecuta en segundo plano. Una vez que se completa este proceso de sincronización, los datos están disponibles para los servicios de terceros a través de la API de Google Health.

Estándares de distancia

Las distancias de ejercicio, como elevationGainMillimeters, se miden en milímetros como unidad estándar por los siguientes motivos:

1. Mantener la precisión de los datos: El motivo más importante para usar milímetros es garantizar que no perdamos precisión en los datos que leemos y proporcionamos. Usar una unidad de medida precisa, como los milímetros, nos permite representar las medidas con alta exactitud.
2. Estandarización: Los milímetros son la unidad estandarizada diseñada para todos nuestros servicios. Esta coherencia ayuda a garantizar una experiencia uniforme para los desarrolladores que interactúan con diferentes partes de la API.
3. Amplio soporte del sistema de medición: Usar una unidad base, como los milímetros, facilita a los desarrolladores la conversión a cualquier otra unidad elegida, independientemente de si trabajan con sistemas métricos, imperiales o de otro tipo.

Duración variable del día

El control del tiempo de la API de Health prioriza el tiempo del usuario para tener en cuenta las duraciones variables del día causadas por el horario de verano o los viajes. Cada punto de datos se almacena con una marca de tiempo UTC física y el desplazamiento UTC activo en el momento del evento. Esto permite que el sistema haga lo siguiente:

• Asigna el evento a un instante físico preciso.
• Corrige la hora según el contexto local del usuario para la agregación.

Horario de verano

Cuando se produce el horario de verano, un "retraso" genera un día civil de 25 horas, y el resumen de esa fecha contendrá 25 horas de datos. Un "adelanto" genera un día civil de 23 horas en el que la hora vuelve a la hora estándar.

Viajes

Los viajes a través de zonas horarias pueden causar variaciones aún más significativas en la duración física de un solo día civil.

Usa el extremo dailyRollUp para conciliar las diferencias de zona horaria. Atribuye automáticamente los datos al día del calendario en el que se registraron según la hora local del usuario, lo que "une" el día de manera eficaz a pesar de los cambios de zona horaria.