Desarrolla experiencias de Pasos con la API de Google Health

La API de Google Health realiza un seguimiento de los pasos del usuario y los datos de actividad con el tipo de datos de intervalo steps. El recuento de pasos representa una medida fundamental de la actividad física diaria, lo que ayuda a los desarrolladores a realizar un seguimiento del progreso del estado físico, calcular el gasto de energía y crear resúmenes de actividad diaria para los usuarios.

Comprende cómo leer y estructurar las métricas de recuento de pasos en tu aplicación para ofrecer la mejor experiencia a tus usuarios.

Tipos de datos admitidos

La API admite el siguiente tipo de datos para realizar un seguimiento de los recuentos de pasos:

Tabla: Tipos de datos de pasos de la API de Google Health

Tipo de datos   dataType   filter parámetro	Tipo de registro	Operaciones disponibles	Alcance	Compatibilidad con webhook	Compatibilidad con ceros verdaderos
Pasos   steps   steps	Intervalo	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

En las siguientes secciones, se proporcionan detalles técnicos para el tipo de datos steps, incluidos ejemplos de representación de REST y lineamientos de integración.

Permisos obligatorios

Para acceder a este tipo de datos, tu app debe solicitar los siguientes permisos de OAuth:

• Lectura: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
• Escritura: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly

Lineamientos

Cuando integres el seguimiento de pasos en tu app, sigue estos lineamientos de diseño e implementación.

Resumen diario

Para agregar recuentos de pasos diarios con precisión durante los viajes, los cambios de zona horaria o el horario de verano, no realices cálculos de duración del cliente. En su lugar, consulta el extremo dailyRollUp, que concilia automáticamente las brechas de datos físicos con los desplazamientos de UTC. El resumen muestra un StepsRollupValue que contiene el campo countSum, que representa el total de pasos acumulados para el día solicitado.

Dibujo de interfaces de usuario (conciliación)

Cuando compiles elementos de la interfaz de usuario para mostrar datos de pasos, usa el extremo reconcile. Si varias fuentes de datos (como un reloj inteligente y un teléfono celular) registraron pasos al mismo tiempo, el extremo reconcile resuelve los conflictos y combina las transmisiones para mostrar una sola transmisión de datos conciliada.

Seguimiento y histogramas intradía

Para mostrar la actividad detallada del usuario durante el día (como gráficos):

• Histogramas de pasos por hora: Consulta el extremo rollUp y especifica la duración (p.ej., 3600s para 1 hora) con el parámetro windowSize.
• Todos los registros de pasos: Usa el extremo list para recuperar los registros de pasos sin procesar más detallados.

Los extremos rollUp y reconcile aceptan el parámetro de consulta dataSourceFamily, lo que te permite filtrar datos de grupos de fuentes específicos.

Sincronización en tiempo real con webhooks

Suscríbete a la colección de tipos de datos steps para recibir notificaciones en tiempo real cuando se importen o sincronicen datos de pasos nuevos. En lugar de sondear extremos de REST, actualiza los paneles del cliente de forma dinámica en respuesta a estas notificaciones de webhook. Para obtener detalles sobre cómo configurar suscripciones, consulta Suscripciones de webhook.

Controla los ceros verdaderos

La API de Google Health implementa ceros verdaderos para resolver intervalos sedentarios. Si un usuario está activo o usa un dispositivo de seguimiento, pero no camina, el dispositivo de seguimiento escribe intervalos de pasos explícitos con un count de "0". Esto te permite distinguir entre los períodos en los que un usuario no dio pasos mientras usaba el dispositivo y cuando no lo usaba en absoluto. Consulta la guía Presencia de datos y ceros verdaderos para obtener más detalles.