Comienza en Android

En esta guía, se explica cómo comenzar a desarrollar con Google Fit en Android.

Nota: Google Fit forma parte de los Servicios de Google Play. Obtén más información sobre los beneficios que obtiene tu app por usar los Servicios de Google Play.

Configuración

Antes de comenzar a compilar la app, completa los pasos que se indican en las siguientes secciones.

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 independiente para probar tu app desde la perspectiva de un usuario.

Obtener los Servicios de Google Play

Obtén la biblioteca cliente más reciente de 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.

Cómo obtener un ID de cliente de OAuth 2.0

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

Cómo crear y configurar tu proyecto

Te recomendamos usar el entorno de desarrollo de Android Studio para compilar una app con la API de Fitness. Para obtener información 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 cliente de los Servicios de Google Play como dependencia:

DSL de Kotlin

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

...

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

DSL genial

apply plugin: 'com.android.application'

...

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

De esta manera, te aseguras de que Gradle descargue automáticamente el SDK de fitness cuando compile tu app.

Compila y prueba tu app

Una vez que termines los pasos de configuración, puedes comenzar a compilar tu app. Para comenzar, obtén información sobre los tipos de datos que tu app puede almacenar y leer. Obtén más información sobre cómo trabajar con datos en Google Fit.

Obtén los permisos necesarios de Android

Para leer y escribir algunos tipos de datos, la 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 los permisos de autorización. Para solicitar estos permisos, debes agregar los tipos de datos a los que tu app necesita acceder en una instancia de FitnessOptions. Cuando la 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 usar esos permisos.

Crea un cliente de API

Crea un cliente de API y agrega los tipos de datos a los que tu app necesita acceder con el objetivo de escribir o leer datos. Los siguientes extremos están disponibles:

• SensorsClient: Accede a diferentes fuentes de datos de salud y bienestar provenientes de los sensores de hardware del dispositivo local y los dispositivos complementarios.
• RecordingClient: Para la recopilación siempre activa de datos de sensores en segundo plano y de baja energía.
• HistoryClient: Inserta, borra y lee los datos históricos en Google Fit.
• SessionsClient: Crea y administra sesiones de actividad del usuario.
• GoalsClient: Leer los objetivos de Punto cardio y Pasos creados por usuarios en Google Fit.
• ConfigClient: Accede a los parámetros de configuración y los tipos de datos personalizados en la plataforma de Google Fit.

Mira un ejemplo de cómo crear un cliente de la API de Fitness.

Flujo de autorización de usuario resultante

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

Figura 1: Flujo de autorización para usuarios.

1. Permisos de Android: Los usuarios ven qué permisos de Android solicitó tu app antes de descargarla. Una vez 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. Check and Connect: La app verifica si se otorgaron permisos antes de solicitar acceso a otros tipos de datos.
3. Solicitud de permisos de OAuth: Google le pide al usuario que otorgue a tu app los permisos de OAuth necesarios para los tipos de datos a los que desea acceder.
4. Acceso aplicado: Después de que el usuario otorga los permisos, la app puede acceder a los tipos de datos que pertenecen a los permisos a los que el usuario les otorgó permiso.

Solicitar verificación

Después de compilar y probar la app, deberás solicitar la verificación con diferentes niveles de justificación necesarios para los permisos sensibles y restringidos.