Les API Google Fit, y compris l'API REST Google Fit, ne seront plus disponibles après le 30 juin 2025. Depuis le 1er mai 2024, les développeurs ne peuvent plus s'inscrire pour utiliser ces API.

Pour obtenir des instructions sur l'API ou la plate-forme vers laquelle effectuer la migration, consultez le guide de migration de Santé Connect. Pour comparer Santé Connect aux API Google Fit et Fitbit Web, consultez le guide comparatif Santé Connect.

Apprenez-en plus sur Santé Connect et sur l'intégration à l'API.

Cette page a été traduite par l'API Cloud Translation.

Premiers pas sur Android

Ce guide explique comment démarrer le développement avec Google Fit sur Android.

Configuration

Avant de commencer à créer votre application, suivez les étapes ci-dessous .

Obtenir un compte Google

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

Installer les services Google Play

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

Ouvrez Android SDK Manager.
Sous SDK Tools, recherchez Services Google Play.
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 Fitness API. Pour pour savoir comment créer un projet et le configurer dans Android Studio, consultez Créez 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:

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

Cela permet de s'assurer que Gradle télécharge automatiquement le SDK de fitness lorsqu'il crée votre application.

Créer et tester votre application

Une fois la configuration terminée, vous pouvez commencer à créer votre application. Pour obtenir Découvrez les types de données que votre application peut stocker de lecture. En savoir plus sur l'utilisation des données dans Google Fit.

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 appli est autorisée à accéder correspondent niveaux d'autorisation. Pour poser une question pour ces autorisations, vous devez ajouter les types de données auxquels votre application a besoin d'accéder dans un FitnessOptions l'instance. Lorsque votre application demande à utiliser des données Google Fit le SDK Android vérifie automatiquement à quels niveaux il appartient et demande à l'utilisateur pour obtenir l'autorisation d'accès à ces champs d'application.

Créer un client API

Créer un client API et ajouter les types de données auxquels votre application doit accéder é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 des données des capteurs en arrière-plan et qui consomme peu d'énergie.
HistoryClient: insérer, supprimer et lire des données historiques dans Google Fit.
SessionsClient: créer et gérer des sessions d'activité de l'utilisateur
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 sur la plate-forme Google Fit.

Consultez un exemple de création d'un client de l'API Fitness.

Flux d'autorisation de l'utilisateur obtenu

Voici le flux d'autorisation obtenu auprès des utilisateurs lorsqu'ils reçoivent une demande d'autorisation:

**Figure 1**. Flux d'autorisation pour les utilisateurs

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

Faire une demande de validation

Après avoir créé et testé votre application, vous devez demander à de validation à l'aide de différentes des niveaux de justification nécessaires pour niveaux d'accès sensibles et restreints.