À propos de l'API Google Health

L'API Web Fitbit a été améliorée et modernisée pour fournir une base plus standardisée, cohérente et évolutive pour les intégrations des développeurs. Elle s'appelle désormais l'API Google Health. L'API Google Health représente l'évolution stratégique de l'ancienne API Web Fitbit, entièrement repensée sur l'infrastructure moderne de Google.

Grâce à cette plate-forme, les développeurs ont accès à toute la puissance des outils pour les développeurs Google Cloud et à un moyen pratique, familier et simplifié permettant aux utilisateurs de gérer leurs autorisations via Google OAuth 2.0.

Quels sont les avantages de l'API Google Health ?

  • Source de vérité unifiée : notre nouveau "flux réconcilié" gère la tâche complexe de réconciliation des points de données qui se chevauchent provenant de plusieurs sources. Cela permet aux applications d'afficher les mêmes données cohérentes que celles que les utilisateurs voient dans l'application Fitbit. Ce flux sera fourni en plus de notre flux propriétaire, qui inclut les données des appareils Fitbit et Pixel, ainsi que les entrées manuelles.
  • Modernisation technique et performances : nous avons regroupé plus de 100 anciens points de terminaison en un ensemble simplifié de types de données, et éliminé les incohérences dans les formats de données, les fuseaux horaires, les unités de mesure et la gestion des erreurs. De plus, nous prenons désormais en charge le protocole HTTP/REST pour la récupération de données hautes performances. De plus, les données intrajournalières et les webhooks sont désormais disponibles pour tous les types de données pertinents via un point de terminaison de liste dédié.
  • Webhooks et évolutivité améliorés : profitez d'une compatibilité étendue avec les webhooks, y compris les abonnements automatiques et la gestion détaillée de tous les types de données pertinents, conçus pour évoluer avec la nouvelle génération d'applications de santé basées sur l'IA.
  • Identité et sécurité simplifiées : remplacez l'ancienne autorisation Fitbit (FOT) par Google OAuth 2.0. Cela permet aux développeurs d'utiliser les bibliothèques d'authentification Google standards, ce qui simplifie les codebases tout en offrant aux utilisateurs un moyen centralisé et familier de gérer leurs autorisations. Tous les champs d'application de l'API Google Health sont classés comme restreints, ce qui nécessite un examen de la confidentialité et de la sécurité pour y accéder.

Vous êtes satisfait ? Lancez-vous !

Versions d'API et version bêta publique

L'API Google Health utilise le contrôle des versions basé sur les canaux conformément aux propositions d'amélioration des API (AIP) de Google, en particulier AIP-185 : contrôle des versions des API et AIP-181 : niveaux de stabilité. L'API est disponible sur deux canaux publics : le canal stable v4 et le canal bêta public v4beta. Google prend en charge les deux canaux via les canaux d'assistance standards.

Comparer les versions stable et bêta

Conformément à la norme AIP-185, le canal v4beta agit comme un sur-ensemble du canal stable v4. Elle inclut toutes les fonctionnalités v4 stables, ainsi que les types de données, les champs et les méthodes en accès anticipé qui sont en cours de test par les partenaires.

Dans la documentation, les éléments d'API qui ne sont disponibles que dans la version bêta affichent le libellé v4beta.

Fonctionnalité Canal stable (v4) Canal bêta public (v4beta)
URI de base REST https://health.googleapis.com/v4 https://health.googleapis.com/v4beta
Package gRPC google.devicesandservices.health.v4 google.devicesandservices.health.v4beta
Documents de référence v4 REST et v4 RPC REST v4beta et RPC v4beta
Niveau de stabilité Prêt pour la production et régi par les règles de rétrocompatibilité AIP-180. Aperçu instable susceptible d'être modifié ou supprimé à tout moment sans préavis.
Utilisation prévue Applications de production en direct visibles par l'utilisateur. Tests précoces, prototypage, validation de schéma et commentaires des développeurs.
Assistance Compatible avec les canaux d'assistance standards. Prise en charge via les canaux d'assistance standards pour les rapports de bugs, le dépannage et les commentaires sur la conception.

Comment traiter le canal v4beta

Lorsque vous explorez des fonctionnalités taguées avec v4beta, suivez ces consignes :

  • Utilisez v4beta principalement dans les environnements de développement, de préproduction et de test hors production. Il n'est pas recommandé de déployer des fonctionnalités de production qui dépendent de points de terminaison v4beta ou de types de données bêta uniquement.
  • Les schémas, les noms de champs, les comportements des points de terminaison et les représentations de données dans v4beta sont susceptibles d'être modifiés sans préavis. Les fonctionnalités et types de données bêta peuvent également être entièrement supprimés s'ils ne répondent pas aux objectifs de validation.
  • Isolez le code client v4beta expérimental derrière des flags de fonctionnalité ou des modules distincts afin que les modifications destructives de la version bêta ne perturbent pas votre intégration v4 principale.
  • Obtenez de l'aide, signalez des problèmes et partagez vos commentaires sur l'implémentation de v4beta via nos canaux d'assistance standards pour nous aider à concevoir l'API finale.

Passage de la version v4beta à la version stable v4

Les nouveaux types de données et fonctionnalités sont ajoutés à v4beta pour permettre aux partenaires de les tester et de les valider avant de passer à la version stable v4.

Google évalue les fonctionnalités bêta par rapport aux critères suivants avant de les promouvoir en v4 :

  • Les tests des partenaires confirment que le modèle de données, la sémantique des champs et les schémas de requête répondent aux exigences des applications réelles.
  • Les commentaires des développeurs et les examens de la conception sont terminés, et le schéma est prêt à être verrouillé conformément aux garanties de rétrocompatibilité AIP-180.
  • Les pipelines de données de bout en bout, la synchronisation des appareils et la fiabilité des services répondent aux normes de qualité de production.
  • Conformément aux règles d'abandon AIP-185, tous les champs ou comportements abandonnés lors des tests bêta sont supprimés plutôt que d'être promus vers v4.

Bien que l'AIP-181 fournisse une règle générale d'environ 90 jours pour l'évaluation bêta, le délai réel de passage d'une fonctionnalité de v4beta à v4 dépend de la complexité de la fonctionnalité, de la disponibilité du matériel et des commentaires de validation. Certaines fonctionnalités peuvent être lancées plus tôt, tandis que d'autres peuvent rester plus longtemps dans v4beta ou être abandonnées.

Lorsqu'un type de données ou une fonctionnalité est promu vers la version stable v4, Google l'annonce dans les notes de version. À ce stade, remplacez https://health.googleapis.com/v4beta par https://health.googleapis.com/v4 dans vos requêtes avant de publier l'intégration auprès des utilisateurs en production.

Qu'en est-il de l'API Web Fitbit ?

L'ancienne API Web Fitbit a été désactivée selon le calendrier suivant :

  • 30 septembre 2026 (fin de la prise en charge) : la prise en charge de l'API Web Fitbit a pris fin, et Google a cessé de corriger les bugs ou de fournir une assistance pour l'API.
  • 2 novembre 2026 (désactivation de l'API) : l'API Web Fitbit et les points de terminaison OAuth Fitbit ont été désactivés et ne fonctionnent plus, ni ne synchronisent les données vers ou depuis les utilisateurs de Google Health. Les requêtes adressées à ces points de terminaison échouent et renvoient un code d'état HTTP 410 Gone.

Les développeurs qui utilisent l'ancienne API Web Fitbit et l'autorisation Fitbit doivent migrer leurs applications et leurs utilisateurs vers l'API Google Health et Google OAuth 2.0.

Pour commencer, consultez le guide de migration.

Quels sont les appareils compatibles ?

Tous les appareils Fitbit et les montres Google Pixel Watch, actuels et précédents, collecteront des données qui seront renvoyées via l'API Google Health. Le type de données disponibles dépend des fonctionnalités de l'appareil.

La liste des appareils actuels est disponible sur le Google Store.

Comment puis-je vous faire parvenir mes commentaires ?

Vos commentaires sont très importants. Nous vous encourageons à nous faire part de vos commentaires via nos canaux d'assistance, qui sont répertoriés sur la page Assistance.

Bien que nous ayons fait tout notre possible pour que ces API vous aident au mieux, l'API Google Health évolue activement. Sachez qu'en fonction de vos commentaires, nous pourrions apporter des modifications d'ici la fin du mois de mai, ce qui nécessiterait des mises à jour de votre côté.

Feuille de route

Voici une liste de fonctionnalités qui seront disponibles en 2026.

T4 2026

Types de données (lecture et écriture)

  • Température cutanée granulaire
  • Métabolisme de base
  • Nous ajouterons des types de données pour atteindre la parité avec Santé Connect. De nombreux autres types de données Santé Connect devraient être ajoutés au quatrième trimestre 2026 et au premier trimestre 2027.

Fonctionnalités

  • Canal bêta public pour un accès anticipé aux nouveaux types de données
  • Point de terminaison de statistiques pour surveiller la télémétrie des webhooks