Guide de migration de Fit

Les API Google Fit seront disponibles jusqu'à la fin de l'année 2026. Google propose plusieurs produits et services de santé et de bien-être pour aider vos utilisateurs à continuer d'atteindre leurs objectifs après l'abandon.

Attention : L'API Google Fit (y compris l'API REST) ne sera disponible 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 directives suivantes indiquent le service vers lequel effectuer la migration en fonction de la façon dont vous utilisez les API Google Fit.

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

Par type d'application

Type d'application Chemin recommandé Raison principale
Application de suivi des pas Santé Connect Lecture mobile des données agrégées sur les pas provenant de différentes sources.
Application associée aux bracelets d'activité sport API Google Health Plate-forme Web nécessitant OAuth pour l'intégration des utilisateurs.
Plate-forme Santé et remise en forme L'API Google Health & Santé 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 intégration actuelle

Intégration actuelle Chemin recommandé Disponibilité
API Fit History et API Fit Session API Google Health Disponible
Lecture des pas 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
Santé Connect Conserver l'intégration existante ou ajouter l'API Google Health Disponible

Comparaisons techniques

Les sections suivantes fournissent une comparaison technique entre les API Google Fit, l'API Google Health et Santé Connect pour vous aider à choisir le bon chemin de migration.

Comparaison entre l'API Fit et l'API Google Health

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 de données Types avec le préfixe 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 pour les applications Android mobiles qui lisent les métriques de l'appareil local.

Fonctionnalité API Fit pour Android Santé Connect
Inscription Console Google Cloud Projet Play Store et déclaration des applications de santé
Authentification OAuth 2.0 requis Aucun OAuth requis (autorisations sur l'appareil)
Stockage de données Centré sur le cloud Centré sur l'appareil (sur l'appareil)
Audience Anciens développeurs Android Développeurs 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'interface utilisateur qui se connectent à l' application Google Fit, consultez les consignes d'intégration 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 connecte 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, procédez comme suit :

Tableau 1 : Étapes de migration à partir de 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 sur mobile (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 locaux dans votre application, implémentez l'écriture de données à l'aide de l'API d'écriture de Santé Connect.

Utilisez Services Santé :

  • PassiveMonitoringClient
  • ExerciseClient

Consultez la documentation sur Services Santé 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 à partir de l'API Fit History
Téléphone Wear

Passez à l'API Google Health.

Non applicable. Utilisez Santé Connect depuis votre application mobile et non depuis 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 à partir de l'API Fit Sensor
Téléphone Wear

Utilisez les API Sensors, Fused Location Provider.

Utilisez Services Santé sur Wear OS :

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Ou utilisez SensorManager, FusedLocationProvider.

Applications utilisant l'API Session pour fournir des résumés 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 à partir de 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 : passez à l'API Google Health.

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

Lecture/Écriture : utilisez 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 à partir de l'API Fit BLE
Téléphone Wear
Utilisez directement les API Android Bluetooth. Utilisez directement les API Android Bluetooth.

Fonctionnalités abandonnées

Les fonctionnalités suivantes ne disposent pas d'une API de remplacement directe. Utilisez les API standards Android 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 disponible. Gérez le suivi des objectifs et les objectifs d'activité quotidienne dans la logique de votre application.
  • API Bluetooth à basse consommation (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 le partage de données, suivez les instructions de migration des utilisateurs existants et nouveaux vers Santé Connect ou l'API Google Health dans ces sections :

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 sur 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 avec des informations sur le moment où vous devrez abandonner l'intégration de votre application Fit et sur 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 d'applications Fit
checkÀ faire closeÀ ne pas faire
Proposez Santé Connect ou l'API Google Health comme nouvelle option dans votre application.

Mettez l'accent sur les avantages pour les utilisateurs, tels que des données et des insights plus riches, 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 Health.

Santé Connect offre un accès à de nouveaux types et sources 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 Web pour les données des appareils Fitbit et Google.

Tableau 8 : Recommandations pour les nouveaux utilisateurs avec des intégrations d'applications Fit
checkÀ faire closeÀ ne pas faire
Incluez Santé Connect ou l'API Google Health dans le flux de configuration de votre application. Proposez Fit comme application à laquelle les utilisateurs peuvent se connecter une fois que Santé Connect est disponible.