Comienza en Android

Crea una Cuenta de Google

Para usar las APIs de Google Fit, necesitas una Cuenta de Google. Puedes crear una cuenta nueva o usar una existente. Es posible que desees crear una cuenta separada para probar tu app desde la perspectiva de un usuario.

Obtener los Servicios de Google Play

Obtén la biblioteca cliente más reciente para los Servicios de Google Play en tu host de desarrollo:

1. Abre Android SDK Manager.
2. En SDK Tools, busca Google Play services.
3. Si el estado de estos paquetes no es Installed, selecciónalos y haz clic en Install Packages.

Obtén un ID de cliente de OAuth 2.0

Para habilitar la API de Fitness, obtén un ID de cliente de OAuth 2.0.

Crea y configura tu proyecto

Te recomendamos que uses el entorno de desarrollo de Android Studio para compilar una app con la API de Fitness. Para obtener detalles sobre cómo crear un proyecto nuevo y configurarlo en Android Studio, consulta Cómo crear un proyecto.

Agrega la biblioteca cliente de los servicios de Google Play

En Android Studio, abre el archivo build.gradle de tu módulo y agrega la biblioteca de cliente de los Servicios de Google Play como una dependencia:

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:21.4.0")
}

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:21.4.0'
}

Esto garantiza que Gradle descargue automáticamente el SDK de Fitness cuando compile tu app.

Obtén los permisos de Android necesarios

Para leer y escribir algunos tipos de datos, tu app debe solicitar permisos de Android.

Obtén permisos de OAuth

Los tipos de datos a los que tu app tiene permiso para acceder corresponden a alcances de autorización. Para solicitar estos permisos, debes agregar los tipos de datos a los que necesita acceder tu app en una instancia de FitnessOptions. Cuando tu app solicita usar cualquiera de los tipos de datos de Google Fit, el SDK de Android verifica automáticamente a qué permisos pertenecen y le solicita al usuario autorización para acceder a ellos.

Crea un cliente de API

Crea un cliente de la API y agrega los tipos de datos a los que tu app necesita acceder para escribir o leer datos. Están disponibles los siguientes extremos:

• SensorsClient: Accede a diferentes fuentes de datos de salud y bienestar desde los sensores de hardware del dispositivo local y de los dispositivos complementarios.
• RecordingClient: Para la recopilación en segundo plano de datos del sensor de bajo consumo y siempre activa.
• HistoryClient: Inserta, borra y lee datos históricos en Google Fit.
• SessionsClient: Crea y administra sesiones de actividad del usuario.
• GoalsClient: Lee los objetivos de Puntos de corazón y Pasos creados por los usuarios en Google Fit.
• ConfigClient: Accede a los tipos de datos y la configuración personalizados en la plataforma de Google Fit.

Consulta un ejemplo de cómo compilar un cliente de la API de Fitness.

Flujo de autorización del usuario resultante

A continuación, se muestra el flujo de autorización resultante que experimentan los usuarios cuando se les solicitan permisos:

1. Permisos de Android: Los usuarios ven los permisos de Android que solicitó tu app antes de descargarla. Después de que se descarga tu app, esta solicita los permisos de tiempo de ejecución que necesita, y los usuarios otorgan o rechazan estos permisos.
2. Verificar y conectar: Tu app verifica si se otorgaron los permisos antes de solicitar acceso a otros tipos de datos.
3. Solicitud de permisos de OAuth: Google le solicita al usuario que le otorgue a tu app los permisos de OAuth necesarios para los tipos de datos a los que quiere acceder.
4. Acceso aplicado: Después de que el usuario otorga permisos, tu app puede acceder a los tipos de datos que pertenecen a los alcances para los que el usuario otorgó permiso.