Acerca de la API de Google Health

La API web de Fitbit se mejoró y modernizó para proporcionar una base más estandarizada, coherente y escalable para las integraciones de desarrolladores, y ahora se llama API de Google Health. La API de Google Health representa la evolución estratégica de la API web de Fitbit heredada, que se volvió a compilar desde cero en la infraestructura moderna de Google.

Con esta plataforma, los desarrolladores obtienen acceso a toda la potencia de las herramientas para desarrolladores de Google Cloud y la comodidad de una forma familiar y optimizada para que los usuarios administren sus permisos a través de Google OAuth 2.0.

¿Qué obtienes con la API de Google Health?

  • Fuente de información unificada: Nuestro nuevo "Flujo conciliado" controla la compleja tarea de conciliar los datos superpuestos de varias fuentes. Esto garantiza que las apps muestren los mismos datos coherentes que los usuarios ven en la app de Fitbit. Este flujo se proporcionará además de nuestro flujo propio, que incluye datos de dispositivos Fitbit y Pixel, así como entradas manuales.
  • Modernización técnica y rendimiento: Consolidamos más de 100 extremos heredados en un conjunto optimizado de paquetes de tipos de datos simplificados y eliminamos las inconsistencias en los formatos de datos, las zonas horarias, las unidades de medida y el manejo de errores. Además, ahora admitimos el protocolo HTTP/REST para la recuperación de datos de alto rendimiento. Además, los datos intradía y los webhooks ya están disponibles para todos los tipos de datos relevantes a través de un extremo de lista dedicado.
  • Webhooks y escalabilidad mejorados: Aprovecha la compatibilidad ampliada con webhooks, incluidas las suscripciones automáticas y la administración detallada de todos los tipos de datos pertinentes, diseñados para escalar con la próxima generación de apps de salud basadas en IA.
  • Identidad y seguridad optimizadas: Reemplaza la autorización de Fitbit heredada (FOT) por Google OAuth 2.0. Esto permite que los desarrolladores usen bibliotecas de autenticación de Google estándar, lo que simplifica las bases de código y, al mismo tiempo, proporciona a los usuarios una forma familiar y centralizada de administrar sus permisos. Todos los permisos de la API de Google Health se clasifican como restringidos, lo que requiere una revisión de privacidad y seguridad para el acceso.

¿Te gusta lo que ves? Comienza ahora.

Versiones de la API y el canal beta público

La API de Google Health usa el control de versiones basado en canales de acuerdo con las propuestas de mejora de la API (AIP) de Google, específicamente AIP-185: Control de versiones de la API y AIP-181: Niveles de estabilidad. La API está disponible en dos canales públicos: el canal estable v4 y el canal de versión beta pública v4beta. Google admite ambos canales a través de los canales de asistencia estándar.

Compara los canales estable y beta

De acuerdo con el AIP-185, el canal v4beta actúa como un superconjunto del canal estable v4. Incluye todas las funciones estables de v4 junto con los tipos de datos, los campos y los métodos de acceso anticipado que se están probando con socios.

En la documentación, los elementos de la API que solo están disponibles en el canal beta muestran la etiqueta v4beta.

Función Canal estable (v4) Canal beta público (v4beta)
URI base de REST https://health.googleapis.com/v4 https://health.googleapis.com/v4beta
Paquete de gRPC google.devicesandservices.health.v4 google.devicesandservices.health.v4beta
Documentos de referencia v4 REST y v4 RPC v4beta REST y v4beta RPC
Nivel de estabilidad Están listas para producción y se rigen por las reglas de retrocompatibilidad de AIP-180. Versión preliminar inestable sujeta a cambios incompatibles o eliminación en cualquier momento sin previo aviso.
Uso previsto Aplicaciones de producción en vivo para el usuario Pruebas tempranas, creación de prototipos, validación de esquemas y comentarios de los desarrolladores.
Asistencia Se admite a través de los canales de asistencia estándar. Se ofrece asistencia a través de los canales de asistencia estándar para informes de errores, solución de problemas y comentarios sobre el diseño.

Cómo tratar el canal v4beta

Cuando explores las capacidades etiquetadas con v4beta, sigue estos lineamientos:

  • Usa v4beta principalmente en entornos de desarrollo, etapa de pruebas y pruebas que no sean de producción. No se recomienda enviar funciones de producción que dependan de extremos v4beta o tipos de datos solo en versión beta.
  • Se espera que los esquemas, los nombres de los campos, los comportamientos de los extremos y las representaciones de datos en v4beta cambien sin previo aviso. Las funciones y los tipos de datos de la versión beta también se pueden quitar por completo si no cumplen con los objetivos de validación.
  • Aísla el código experimental del cliente de v4beta detrás de marcas de función o módulos independientes para que los cambios rotundos en el canal beta no interrumpan tu integración principal de v4.
  • Obtén asistencia, informa problemas y comparte comentarios sobre la implementación de v4beta a través de nuestros canales de asistencia estándar para ayudar a definir el diseño final de la API.

Ascenso de v4beta a v4 estable

Los nuevos tipos de datos y funciones ingresan a v4beta para admitir las pruebas de los socios y la validación del mercado antes de pasar al canal estable v4.

Google evalúa las funciones de la fase beta según los siguientes criterios antes de promoverlas a v4:

  • Las pruebas de los socios confirman que el modelo de datos, la semántica de los campos y los patrones de consulta cumplen con los requisitos de las aplicaciones del mundo real.
  • Se completaron los comentarios de los desarrolladores y las revisiones de diseño, y el esquema está listo para bloquearse según las garantías de retrocompatibilidad de AIP-180.
  • Las canalizaciones de datos de extremo a extremo, la sincronización de dispositivos y la confiabilidad del servicio cumplen con los estándares de calidad de producción.
  • De acuerdo con las reglas de baja de AIP-185, los campos o comportamientos que se hayan dado de baja durante la prueba beta se quitarán en lugar de promoverse a v4.

Si bien AIP-181 proporciona una regla general de aproximadamente 90 días para la evaluación de la versión beta, el tiempo real para promover una función de v4beta a v4 depende de la complejidad de la función, la disponibilidad del hardware y los comentarios de validación. Es posible que algunas funciones se lancen antes, mientras que otras pueden permanecer en v4beta por más tiempo o descontinuarse.

Cuando un tipo de datos o una función se promocionan al canal estable v4, Google anuncia la graduación en las Notas de la versión. En ese momento, actualiza tus solicitudes de https://health.googleapis.com/v4beta a https://health.googleapis.com/v4 antes de lanzar la integración a los usuarios de producción.

¿Qué sucederá con la API web de Fitbit?

La API web de Fitbit heredada se desactivó según el siguiente cronograma:

  • 30 de septiembre de 2026 (fin de la asistencia): Finalizó la asistencia para la API web de Fitbit, y Google dejó de corregir errores y de brindar asistencia para la API.
  • 2 de noviembre de 2026 (desactivación de la API): Se desactivaron la API web de Fitbit y los extremos de OAuth de Fitbit, y ya no funcionan ni sincronizan datos de los usuarios de Google Health ni con ellos. Las solicitudes a estos extremos fallan y devuelven un código de estado HTTP 410 Gone.

Los desarrolladores que usan la API web de Fitbit y la autorización de Fitbit heredadas deben migrar sus aplicaciones y usuarios a la API de Google Health y a Google OAuth 2.0.

Consulta la guía de migración para comenzar.

¿Qué dispositivos son compatibles?

Todos los dispositivos Fitbit y Google Pixel Watch, actuales y anteriores, recopilarán datos que se devolverán a través de la API de Google Health. El tipo de datos disponibles dependerá de la funcionalidad que admitan los dispositivos.

La lista de dispositivos actuales se puede encontrar en Google Store.

¿Cómo puedo enviar comentarios?

Valoramos mucho tus comentarios. Te recomendamos que compartas tus opiniones a través de nuestros canales de asistencia, que se indican en la página Asistencia.

Si bien hicimos todo lo posible para garantizar que estas APIs te brinden una buena asistencia, la API de Google Health está en constante evolución. Ten en cuenta que, según tus comentarios, es posible que introduzcamos cambios entre este momento y finales de mayo que requieran las actualizaciones correspondientes de tu parte.

Hoja de ruta

Esta es una lista de las funciones que se lanzarán en 2026.

Cuarto trimestre de 2026

Tipos de datos (lectura y escritura)

  • Temperatura cutánea detallada
  • Tasa metabólica basal
  • Agregaremos tipos de datos para alcanzar la paridad con Health Connect. Se espera que se agreguen muchos más tipos de datos de Health Connect en el cuarto trimestre de 2026 y el primer trimestre de 2027.

Funciones

  • Canal de versión beta pública para obtener acceso anticipado a nuevos tipos de datos
  • Extremo de estadísticas para supervisar la telemetría de los webhooks