Guía de migración de Fit

Las APIs de Google Fit se admitirán hasta fines de 2026. Google ofrece varios productos y servicios de salud y bienestar que pueden ayudar a tus usuarios a seguir alcanzando sus objetivos después de esta baja.

Precaución: La API de Google Fit (incluida la API de REST) solo se admitirá hasta fines de 2026. Te recomendamos que migres a la API de Google Health para integraciones basadas en la nube o a Health Connect para el seguimiento de pasos y las apps que priorizan los dispositivos móviles.

En los siguientes lineamientos, se muestra a qué servicio debes migrar según cómo uses las APIs de Google Fit.

La elección de la API debe basarse en el tipo de aplicación y las necesidades de datos específicas.

Por tipo de aplicación

Tipo de aplicación Ruta recomendada Motivo principal
App de seguimiento de pasos Health Connect Lectura centrada en dispositivos móviles de datos agregados de pasos de varias fuentes
App complementaria de dispositivos de seguimiento de actividad física API de Google Health Plataforma centrada en la Web que requiere OAuth para la integración del usuario
Plataforma de salud y fitness API de Google Health y Health Connect Usa la API de Google Health para los datos de dispositivos de Fitbit o Google y Health Connect para los datos agregados integrados en el dispositivo.

Por integración actual

Integración actual Ruta recomendada Disponibilidad
API de History de Fit y API de Session de Fit API de Google Health Disponible
Lectura de pasos en dispositivos móviles (con la API de Recording de Google Fit) Health Connect Disponible
API de Fit en Wear OS Servicios de salud Disponible
API web de Fitbit API de Google Health Disponible
Health Connect Mantén la integración existente o agrega la API de Google Health Disponible

Comparaciones técnicas

En las siguientes secciones, se proporciona una comparación técnica entre las APIs de Google Fit, la API de Google Health y Health Connect para ayudarte a elegir la ruta de migración correcta.

API de Fit en comparación con la API de Google Health

Usa esta ruta si tu app es una plataforma basada en la Web o requiere interacciones de servidor a servidor (S2S).

Función API de Fit (Android/REST) API de Google Health
Configuración del proyecto Google Cloud Console Crea un proyecto de Google Cloud
Configuración de OAuth Tipo de aplicación para Android o Web Tipo de aplicación web
Arquitectura de datos Tipos con el prefijo com.google Tipos de datos unificados de la API de Google Health
Registro de la app Crea un proyecto de Google Cloud Crea un proyecto de Google Cloud y habilita la API de Google Health

API de Fit en comparación con Health Connect

Usa esta ruta para las aplicaciones de Android que priorizan los dispositivos móviles y que leen métricas de dispositivos locales.

Función API de Fit para Android Health Connect
Registro Google Cloud Console Proyecto de Play Store y declaración de apps de salud
Autenticación Se requiere OAuth 2.0 No se requiere OAuth (permisos integrados en el dispositivo)
Almacenamiento de datos Centrado en la nube Centrado en el dispositivo (en el dispositivo)
Público Desarrolladores de Android heredados Desarrolladores de Modern Android para dispositivos móviles
Permisos Alcances de OAuth Permisos del manifiesto de Android

Integraciones de las APIs de Fit

En las siguientes secciones, se proporciona orientación para migrar desde cada una de las APIs de Google Fit. Si tu integración también incluye elementos de la IU que se conectan a la app de Google Fit, consulta los lineamientos de integraciones de la app de Fit para obtener más orientación.

Apps que usan la API de Recording de Fit para registrar pasos

La API de Recording de Fit permite que tu app solicite el almacenamiento automatizado de datos de sensores haciendo un uso eficiente de la batería mediante la creación de suscripciones. Cada suscripción conecta una app para Android a un tipo de datos de actividad física o una fuente de datos en particular, y el tipo de datos Step se usa comúnmente para registrar pasos.

Sigue estos pasos para migrar desde la API de Recording de Fit:

Tabla 1: Pasos de migración desde la API de Recording de Fit
Teléfono Wear
  1. Para mostrar un recuento total de pasos, agrega Health Connect a tu app. El total incluye pasos registrados con dispositivos móviles (Android 14 o versiones posteriores) y pasos de otras apps y dispositivos.
  2. Para seguir mostrando los datos de pasos locales en tu app, implementa la escritura de datos con la API de escritura de Health Connect.

Usa Servicios de salud:

  • PassiveMonitoringClient
  • ExerciseClient

(consulta la documentación de Servicios de salud para obtener más información sobre las diferencias entre ambos)

Apps que usan la API de History para leer o escribir datos en el almacén de fitness

La API de History permite que tu app realice operaciones masivas en el almacén de fitness. Estas operaciones incluyen leer, insertar, actualizar y borrar datos históricos de salud y bienestar.

Sigue estos pasos para migrar desde la API de History:

Tabla 2: Pasos de migración desde la API de History de Fit
Teléfono Wear

Haz la transición a la API de Google Health.

No aplicable. Usa Health Connect desde la app para dispositivos móviles y no desde el wearable.

Apps que usan la API de Sensor para mostrar datos de actividad física en tiempo real

La API de Sensor te permite leer datos de sensores sin procesar en tu app en tiempo real. La API de Sensor hace lo siguiente:

  • Muestra una lista de las fuentes de datos disponibles en el dispositivo y en los dispositivos complementarios.
  • Registra los objetos de escucha para recibir datos de sensores sin procesar.
  • Cancela el registro de los objetos de escucha de modo que ya no reciban datos de sensores sin procesar.

Sigue estos pasos para migrar desde la API de Sensor:

Tabla 3: Pasos de migración desde la API de Sensor de Fit
Teléfono Wear

Usa la API de Sensors y la de proveedor de ubicación combinada.

Usa los Servicios de salud en Wear OS:

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    También puedes usar SensorManager, FusedLocationProvider.

Apps que usan la API de Session para proporcionar resúmenes de actividad

Las sesiones representan un intervalo durante el cual los usuarios realizan una actividad física.

La API de Session permite que tu app cree sesiones en el almacén de fitness.

Sigue estos pasos para migrar desde la API de Session:

Tabla 4: Pasos de migración desde la API de Session de Fit
Teléfono Wear

Iniciar/detener: No aplicable. La aplicación debe realizar un seguimiento interno del estado de las sesiones en curso.

Leer/escribir: Haz la transición a la API de Google Health.

Iniciar/detener: Usa Servicios de salud (ExerciseClient).

Leer/escribir: Usa Health Connect con tu app para dispositivos móviles.

Para flujos de trabajo específicos, te recomendamos lo siguiente:

  • Insertar una sesión: Los desarrolladores deben usar Health Connect con su app para dispositivos móviles y, en consecuencia, insertar un objeto ExerciseSessionRecord o un objeto SleepSessionRecord.

Apps que usan la API de Goals

Los objetivos son las metas de la app de Google Fit que los usuarios pueden establecer para sus métricas, como los pasos y los puntos cardio. La plataforma de Fit registra sus objetivos y realiza un seguimiento de su actividad diaria con respecto a esos objetivos mediante la API de Goals.

Tabla 5: Orientación para la migración desde la API de Goals de Fit
Teléfono Wear
No hay una API de reemplazo disponible. No hay una API de reemplazo disponible.

Apps que usan la API de BLE

Tu app puede buscar dispositivos Bluetooth de bajo consumo (BLE) disponibles e insertar datos de sensores en la plataforma de Google Fit con la API de BLE.

Sigue estos pasos para migrar desde la API de BLE:

Tabla 6: Pasos de migración desde la API de BLE de Fit
Teléfono Wear
Usa las APIs de Bluetooth para Android directamente. Usa las APIs de Bluetooth para Android directamente.

Funciones obsoletas

Las siguientes funciones no tienen un reemplazo directo de la API. Usa las APIs estándar de Android recomendadas:

  • API de Sensor: Usa el framework de Sensors de Android o la API de proveedor de ubicación combinada para obtener datos sin procesar en tiempo real.
  • API de Goals: No hay una API de reemplazo disponible. Administra el seguimiento de objetivos y las metas de actividad diaria dentro de la lógica de tu aplicación.
  • API de Bluetooth de bajo consumo (BLE): Usa las APIs de Bluetooth para Android directamente para comunicarte con el hardware.

Integraciones de la app de Fit

Si tu app se conecta a Google Fit para compartir datos, sigue las instrucciones para migrar usuarios existentes y nuevos a Health Connect o a la API de Google Health en estas secciones:

Usuarios existentes de tu app

Si la IU de tu app incluye una forma para que los usuarios se conecten a Google Fit (o si tu app se incluye en la lista de apps que funcionan con Google Fit), puedes seguir manteniendo la integración de tu app de Fit para los usuarios actuales.

Mantendremos esta sección actualizada con información sobre cuándo dar de baja la integración de tu app de Fit y cuáles son las mejores opciones para mantener la experiencia del usuario. Mientras tanto, puedes comunicarte con nosotros.

Tabla 7: Recomendaciones para usuarios existentes con integraciones de la app de Fit
checkSigue estas recomendaciones closeNo hagas esto
Ofrece Health Connect o la API de Google Health como una opción nueva en tu app.

Enfócate en los beneficios para los usuarios, como datos y estadísticas más enriquecidos, privacidad y seguridad.

Cómo sincronizar con Health Connect

Indicarles a los usuarios que se desconecten de Google Fit.

Cómo desconectarse de Health Connect

Usuarios nuevos de tu app

Para ofrecer una experiencia similar a los usuarios nuevos de tu app, te recomendamos que crees una integración con Health Connect o la API de Google Health.

Health Connect ofrece acceso a nuevos tipos y fuentes de datos para brindar una mejor experiencia a los usuarios, con datos almacenados de forma segura integrado en el dispositivo. La API de Google Health proporciona una plataforma centrada en la Web para los datos de dispositivos de Fitbit y Google.

Tabla 8: Recomendaciones para usuarios nuevos con integraciones de la app de Fit
checkSigue estas recomendaciones closeNo hagas esto
Incluye Health Connect o la API de Google Health en el flujo de configuración de tu app. Ofrecer Fit como una app a la que los usuarios se pueden conectar una vez que Health Connect esté disponible.