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 permiso 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
Minutos de actividad   active-minutes   active_minutes	Intervalo	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	list, reconcile	activity_and_fitness
Altitud   altitude   altitude	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
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
Variabilidad de la frecuencia cardíaca diaria   daily-heart-rate-variability   daily_heart_rate_variability	Diario	list, reconcile	health_metrics_and_measurements
Zonas de frecuencia cardíaca diarias   daily-heart-rate-zones   daily_heart_rate_zones	Diario	conciliar	health_metrics_and_measurements
Saturación de oxígeno diaria   daily-oxygen-saturation   daily_oxygen_saturation	Diario	list, reconcile	health_metrics_and_measurements
Frecuencia respiratoria diaria   daily-respiratory-rate   daily_respiratory_rate	Diario	list, reconcile	health_metrics_and_measurements
Frecuencia cardíaca en reposo diaria   daily-resting-heart-rate   daily_resting_heart_rate	Diario	list, reconcile	health_metrics_and_measurements
Derivaciones diarias de la temperatura durante el sueño   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	Diario	list, reconcile	health_metrics_and_measurements
VO2 máx. diario   daily-vo2-max   daily_vo2_max	Diario	list, reconcile	activity_and_fitness
Distancia   distance   distance	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Ejercicio   exercise   exercise	Sesión	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Pisos   floors   floors	Intervalo	reconcile, rollup, dailyRollup	activity_and_fitness
Frecuencia cardíaca   heart-rate   heart_rate	Muestra	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Variabilidad de la frecuencia cardíaca   heart-rate-variability   heart_rate_variability	Muestra	list, reconcile	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
Saturación de oxígeno   oxygen-saturation   oxygen_saturation	Muestra	list, reconcile	health_metrics_and_measurements
Resumen de sueño de la frecuencia respiratoria   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Muestra	list, reconcile	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	sleep
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	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	list, reconcile	activity_and_fitness
Peso   weight   weight	Muestra	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

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 grano fino, como los milímetros, nos permite representar las medidas con alta precisión.
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.