Premiers pas sur Android

Obtenir un compte Google

Pour utiliser les API Google Fit, vous devez disposer d'un compte Google. Vous pouvez créer un compte ou utiliser un compte existant. Vous pouvez créer un compte distinct pour tester votre application du point de vue d'un utilisateur.

Installer les services Google Play

Obtenez la dernière bibliothèque cliente pour les services Google Play sur votre hôte de développement :

1. Ouvrez Android SDK Manager.
2. Sous SDK Tools, recherchez Google Play services.
3. Si l'état de ces packages n'est pas Installé, sélectionnez-les tous les deux et cliquez sur Installer les packages.

Obtenir un ID client OAuth 2.0

Pour activer l'API Fitness, obtenez un ID client OAuth 2.0.

Créer et configurer votre projet

Nous vous recommandons d'utiliser l'environnement de développement Android Studio pour créer une application avec l'API Fitness. Pour savoir comment créer un projet et le configurer dans Android Studio, consultez Créer un projet.

Ajouter la bibliothèque cliente des services Google Play

Dans Android Studio, ouvrez le fichier build.gradle de votre module et ajoutez la bibliothèque cliente des services Google Play en tant que dépendance :

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

Cela permet à Gradle de télécharger automatiquement le SDK Fitness lorsqu'il compile votre application.

Obtenir les autorisations Android nécessaires

Pour lire et écrire certains types de données, votre application doit demander des autorisations Android.

Obtenir les autorisations OAuth

Les types de données auxquels votre application est autorisée à accéder correspondent aux scopes d'autorisation. Pour demander ces autorisations, vous devez ajouter les types de données auxquels votre application doit accéder dans une instance FitnessOptions. Lorsque votre application demande à utiliser l'un des types de données Google Fit, le SDK Android vérifie automatiquement à quelles autorisations ils appartiennent et demande à l'utilisateur l'autorisation d'accéder à ces autorisations.

Créer un client API

Créez un client API et ajoutez les types de données auxquels votre application doit accéder pour écrire ou lire des données. Les points de terminaison suivants sont disponibles :

• SensorsClient : accédez à différentes sources de données de santé et de bien-être à partir des capteurs matériels de l'appareil local et des appareils associés.
• RecordingClient : pour la collecte en arrière-plan des données de capteurs, toujours activée et à faible consommation d'énergie.
• HistoryClient : insérer, supprimer et lire des données historiques dans Google Fit.
• SessionsClient : créez et gérez les sessions d'activité des utilisateurs.
• GoalsClient : lire les objectifs de points cardio et de pas créés par les utilisateurs dans Google Fit.
• ConfigClient : accédez aux types de données et aux paramètres personnalisés dans la plate-forme Google Fit.

Découvrez un exemple de création d'un client Fitness API.

Flux d'autorisation de l'utilisateur

Vous trouverez ci-dessous le flux d'autorisation que les utilisateurs rencontrent lorsqu'ils sont invités à accorder des autorisations :

1. Autorisations Android : les utilisateurs voient les autorisations Android que votre application a demandées avant de la télécharger. Une fois votre application téléchargée, elle demande les autorisations d'exécution dont elle a besoin, et les utilisateurs les accordent ou les refusent.
2. Vérifier et se connecter : votre application vérifie si des autorisations ont été accordées avant de demander l'accès à d'autres types de données.
3. Demande d'habilitations OAuth : Google invite l'utilisateur à accorder à votre application les habilitations OAuth nécessaires pour les types de données auxquels elle souhaite accéder.
4. Accès appliqué : une fois que l'utilisateur a accordé les autorisations, votre application peut accéder aux types de données qui appartiennent aux niveaux d'accès pour lesquels l'utilisateur a accordé l'autorisation.