Guide de migration de Fit

Les API Google Fit sont obsolètes et leur arrêt est prévu pour fin 2026. Google propose plusieurs produits et services de santé et de bien-être pour aider vos utilisateurs à continuer à atteindre leurs objectifs après l'arrêt de l'application.

Attention : L'API Google Fit (y compris l'API REST) ne sera compatible que jusqu'à la fin de l'année 2026. Nous vous recommandons de migrer vers l'API Google Health pour les intégrations basées sur le cloud ou vers Santé Connect pour le suivi des pas et les applications mobiles.

Les consignes suivantes indiquent le service vers lequel effectuer la migration en fonction de votre utilisation des API Google Fit.

Le choix de l'API doit être basé sur le type d'application et les besoins spécifiques en données.

Par type d'application

Type d'application Parcours recommandé Raison principale
Application de suivi des pas Santé Connect Lecture axée sur le mobile des données agrégées sur les pas provenant de différentes sources.
Application associée aux bracelets d'activité API Google Health Plate-forme axée sur le Web nécessitant OAuth pour l'intégration des utilisateurs.
Plate-forme Santé et remise en forme L'API Google Health et Health Connect Utilisez l'API Google Health pour les données des appareils Fitbit/Google et Santé Connect pour les données agrégées sur l'appareil.

Par l'intégration actuelle

Intégration actuelle Parcours recommandé Disponibilité
Google Fit (Android et API REST) API Google Health Disponible
Lire les pas effectués sur mobile (avec l'API Google Fit Recording) Santé Connect Disponible
API Fit sur Wear OS Services Santé Disponible
API Web Fitbit API Google Health Disponible
API Recording sur mobile Santé Connect Disponible
Santé Connect Conserver l'intégration existante ou ajouter l'API Google Santé Disponible

Comparaisons techniques

Les sections suivantes fournissent une comparaison technique entre les API Google Fit, l'API Google Santé et Santé Connect pour vous aider à choisir la bonne voie de migration.

Comparaison entre l'API Fit et l'API Google Santé

Utilisez ce chemin si votre application est une plate-forme Web ou nécessite des interactions de serveur à serveur (S2S).

Fonctionnalité API Fit (Android/REST) API Google Health
Configuration du projet Console Google Cloud Créer un projet Google Cloud
Configuration OAuth Type d'application Android ou Web Type d'application Web
Architecture des données Types préfixés com.google Types de données unifiés de l'API Google Health
Enregistrement de l'application Créer un projet Google Cloud Créer un projet Google Cloud et activer l'API Google Health

Comparaison entre l'API Fit et Santé Connect

Utilisez ce chemin d'accès pour les applications Android axées sur le mobile qui lisent les métriques de l'appareil local.

Fonctionnalité API Fit pour Android Santé Connect
Enregistrements Google Cloud Console Projet Play Store et déclaration pour les applications de santé
Authentification OAuth 2.0 requis Aucun OAuth requis (autorisations sur l'appareil)
Stockage des données Centré sur le cloud Axé sur l'appareil (sur l'appareil)
Audience Anciens développeurs Android Développeurs d'applications mobiles Android modernes
Autorisations Champs d'application OAuth Autorisations du fichier manifeste Android

Intégrations de l'API Fit

Les sections suivantes fournissent des conseils sur la migration à partir de chacune des API Google Fit. Si votre intégration inclut également des éléments d'UI qui se connectent à l'application Google Fit, consultez les Consignes relatives aux intégrations de l'application Fit pour obtenir des conseils supplémentaires.

Applications utilisant l'API Fit Recording pour enregistrer les pas

L'API Fit Recording permet à votre application de demander le stockage automatisé des données de capteurs de manière économe en batterie en créant des abonnements. Chaque abonnement associe une application Android à un type de données de remise en forme ou à une source de données spécifique. Le type de données Step est couramment utilisé pour enregistrer les pas.

Pour migrer à partir de l'API Fit Recording :

Tableau 1 : Étapes de migration depuis l'API Fit Recording
Téléphone Wear
  1. Pour afficher le nombre total de pas, ajoutez Santé Connect à votre application. Le total inclut les pas mobiles (Android 14 ou version ultérieure) et les pas provenant d'autres applications et appareils.
  2. Pour continuer à afficher les données sur les pas effectués localement dans votre application, implémentez l'écriture de données à l'aide de l'API d'écriture de Santé Connect.

Utiliser Services Santé :

  • PassiveMonitoringClient
  • ExerciseClient

Consultez la documentation Health Services pour en savoir plus sur les différences entre les deux.

Applications utilisant l'API History pour lire ou écrire des données dans le référentiel de remise en forme

L'API History permet à votre application d'effectuer des opérations groupées sur le référentiel de remise en forme. Ces opérations incluent la lecture, l'insertion, la mise à jour et la suppression de données historiques sur la santé et le bien-être.

Pour migrer à partir de l'API History, procédez comme suit :

Tableau 2 : Étapes de migration depuis l'API Fit History
Téléphone Wear

Passer à l'API Google Health

Non applicable. Utilisez Santé Connect depuis votre application mobile et non l'accessoire connecté.

Applications utilisant l'API Sensor pour afficher des données de remise en forme en temps réel

L'API Sensor vous permet de lire les données brutes des capteurs dans votre application en temps réel. L'API Sensor effectue les opérations suivantes :

  • Répertorie les sources de données disponibles sur l'appareil et sur les appareils associés.
  • Enregistre les écouteurs pour recevoir les données brutes des capteurs.
  • Désenregistre les écouteurs afin qu'ils ne reçoivent plus les données brutes des capteurs.

Pour migrer à partir de l'API Sensor, procédez comme suit :

Tableau 3 : Étapes de migration depuis l'API Fit Sensor
Téléphone Wear

Utiliser Sensors, API Fused Location Provider

Utiliser les Services Santé sur Wear OS :

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Vous pouvez également utiliser SensorManager, FusedLocationProvider

Applications utilisant l'API Session pour fournir des récapitulatifs d'activité

Les sessions représentent un intervalle de temps pendant lequel les utilisateurs font une activité physique.

L'API Session permet à votre application de créer des sessions dans le référentiel de remise en forme.

Pour migrer à partir de l'API Session, procédez comme suit :

Tableau 4 : Étapes de migration depuis l'API Fit Session
Téléphone Wear

Début/Arrêt : non applicable. L'application doit suivre l'état des sessions en cours en interne.

Lecture/Écriture : Passer à l'API Google Health

Démarrer/Arrêter : utiliser Services Santé (ExerciseClient)

Lecture/Écriture : utiliser Santé Connect avec votre application mobile

Pour des workflows spécifiques, nous vous recommandons de suivre les conseils suivants :

  • Insérer une session : les développeurs doivent utiliser Santé Connect avec leur application mobile et insérer un ExerciseSessionRecord ou un SleepSessionRecord en conséquence.

Applications utilisant l'API Goals

Les utilisateurs peuvent se fixer des objectifs dans l'application Google Fit pour leurs métriques, comme les pas et les points cardio. La plate-forme Fit enregistre leurs objectifs et suit leur activité quotidienne à l'aide de l'API Goals.

Tableau 5 : Conseils de migration pour l'API Fit Goals
Téléphone Wear
Aucune API de remplacement disponible. Aucune API de remplacement disponible.

Applications utilisant l'API BLE

Votre application peut détecter les appareils Bluetooth à basse consommation (BLE) disponibles et insérer les données des capteurs dans la plate-forme Google Fit à l'aide de l'API BLE.

Pour migrer à partir de l'API BLE, procédez comme suit :

Tableau 6 : Étapes de migration depuis l'API Fit BLE
Téléphone Wear
Utilisez directement les API Android Bluetooth. Utilisez directement les API Android Bluetooth.

Fonctionnalités obsolètes

Les fonctionnalités suivantes ne peuvent pas être remplacées directement par une API. Utilisez les API Android standards recommandées :

  • API Sensor : utilisez le framework Android Sensors ou l'API Fused Location Provider pour obtenir des données brutes en temps réel.
  • API Goals : aucune API de remplacement n'est disponible. Gérez le suivi des objectifs et les cibles d'activité quotidienne dans la logique de votre application.
  • API Bluetooth Low Energy (BLE) : utilisez directement les API Android Bluetooth pour communiquer avec le matériel.

Intégrations de l'application Fit

Si votre application se connecte à Google Fit pour partager des données, suivez les instructions pour migrer les utilisateurs existants et nouveaux vers Santé Connect ou l'API Google Santé dans les sections suivantes :

Utilisateurs existants de votre application

Si l'interface utilisateur de votre application permet aux utilisateurs de se connecter à Google Fit (ou si votre application figure dans la liste des applications compatibles avec Google Fit), vous pouvez continuer à gérer l'intégration de votre application Fit pour les utilisateurs actuels.

Nous mettrons à jour cette section pour vous indiquer quand abandonner l'intégration de votre application Fit et quelles sont les meilleures options pour maintenir votre expérience utilisateur. En attendant, vous pouvez nous contacter.

Tableau 7 : Recommandations pour les utilisateurs existants avec des intégrations de l'application Fit
checkSuivez ces conseils FermerÀ ne pas faire
Proposez Santé Connect ou l'API Google Santé comme nouvelle option dans votre application.

Mettez l'accent sur les avantages pour les utilisateurs, comme des données et des insights plus détaillés, la confidentialité et la sécurité.

Synchroniser avec Santé Connect

Demandez aux utilisateurs de se déconnecter de Google Fit.

Se déconnecter de Santé Connect

Nouveaux utilisateurs de votre application

Pour offrir une expérience similaire aux nouveaux utilisateurs de votre application, nous vous recommandons de créer une intégration avec Santé Connect ou l'API Google Santé.

Santé Connect permet d'accéder à de nouvelles sources et de nouveaux types de données pour offrir une expérience plus riche aux utilisateurs, avec des données stockées de manière sécurisée sur l'appareil. L'API Google Health fournit une plate-forme axée sur le Web pour les données des appareils Fitbit et Google.

Tableau 8 : Recommandations pour les nouveaux utilisateurs avec intégrations de l'appli Fit
checkSuivez ces conseils FermerÀ ne pas faire
Incluez Santé Connect ou l'API Google Santé dans le flux de configuration de votre application. Proposez Fit comme application que les utilisateurs peuvent connecter une fois que Santé Connect est disponible.