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 Beneficios que obtiene tu app por el uso de Google Play Servicios.

Configuración

Antes de comenzar a compilar tu app, completa los pasos que se indican a continuación 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 cuenta existente. Puede crear otra cuenta para probar desde la perspectiva del usuario.

Obtener los Servicios de Google Play

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

1. Abre Android SDK Manager.
2. En SDK Tools, busca Servicios de Google Play.
3. Si el estado de este paquete no es Instalado, seleccione ambos. y haz clic en Instalar paquetes.

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 que uses el entorno de desarrollo de Android Studio para compilar una app con la API de Fitness. Para sobre cómo crear un nuevo proyecto y configurarlo en Android Studio, consulta Crea un proyecto.

Agrega la biblioteca cliente de Servicios de Google Play

En Android Studio, abre el archivo build.gradle para tu módulo y agrega la biblioteca cliente de 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 de Groovy

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'
}

Esto garantiza que Gradle descargue automáticamente el SDK de fitness cuando compila tu app.

Compila y prueba tu app

Una vez que completes los pasos de configuración, podrás comenzar a compilar tu app. Para obtener 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 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 permisos de autorización. Para preguntar para estos permisos, debes agregar a qué tipos de datos necesita acceder tu app en un FitnessOptions de Compute Engine. Cuando la app solicita usar los datos de Google Fit el SDK de Android comprueba automáticamente a qué ámbitos pertenecen y pregunta al usuario para obtener autorización a esos ámbitos.

Crea un cliente de API

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

• SensorsClient: Accede a diferentes fuentes de datos de salud y bienestar desde los sensores de hardware del dispositivo local y los dispositivos complementarios.
• RecordingClient: Para la recopilación de datos de sensores en segundo plano y de bajo consumo, que está 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 cardio y Pasos creados por usuarios en Google Fit.
• ConfigClient: Accede a parámetros de configuración y 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 resultante de autorización de usuarios

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

Figura 1: Flujo de autorización para usuarios.

1. Permisos de Android: Los usuarios ven los permisos de Android que otorga tu app. solicitado antes de descargarlo. Una vez que se descarga la aplicación, solicita los permisos de tiempo de ejecución que necesite y los usuarios otorgan o deniegan estos permisos.
2. Verificar y conectarse: La app verifica si se aplicaron los permisos otorgada antes de solicitar acceso a otros tipos de datos.
3. Solicitud de alcance de OAuth: Google le solicita al usuario que otorgue a tu aplicación. 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 los permisos, tu app puede acceder a los tipos de datos que pertenecen a los permisos que otorgó el usuario permiso.

Solicitar verificación

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