Premiers pas

Bienvenue dans l'API Google Health !

Cette nouvelle API utilise Google OAuth, ce qui offre une solution plus sécurisée, conviviale et évolutive pour accéder aux données de santé et les gérer. Voici quelques-uns des avantages :

  • Sécurité renforcée : la nouvelle API est conforme aux recommandations et aux bonnes pratiques de Google en matière de sécurité pour la conception et l'implémentation des API, ce qui réduit le risque de failles.

  • Cohérence : la nouvelle API suit les principes de conception des API modernes, offrant une expérience de développement plus cohérente et intuitive.

  • Pérennité

    • Évolutivité : la nouvelle API est conçue pour évoluer et répondre aux besoins futurs, en prenant en charge un nombre croissant d'utilisateurs et de types de données.
    • Maintenabilité : l'adoption d'une approche standardisée facilite la maintenance et la mise à jour des applications, ce qui réduit la dette technique.
    • Accès aux nouvelles fonctionnalités : la migration vers la nouvelle API permet d'accéder aux nouvelles fonctionnalités à mesure qu'elles sont disponibles. Les applications restent ainsi à jour et bénéficient des dernières avancées.
    • Conformité : la nouvelle API est mise à jour avec les dernières normes de sécurité et de confidentialité de Google, ce qui réduit l'effort requis pour maintenir la conformité des applications.
    • Confidentialité des données : le système Google OAuth est conçu pour respecter diverses réglementations sur la confidentialité des données (par exemple, le RGPD et la loi HIPAA), ce qui simplifie la charge de conformité pour les développeurs.

Comment commencer ?

Avant de commencer le développement, consultez notre checklist pour les développeurs, qui fournit une liste d'étapes pour vous aider à lancer votre intégration avec l'API Google Health.

La procédure de démarrage dépend également du type de développeur que vous êtes.

Nouveau développeur

Si vous n'avez aucune expérience avec les API Google ou Google Cloud, ou si vous avez besoin d'un rappel, le moyen le plus simple et le plus rapide de vous lancer est de suivre l'atelier de programmation. Il vous montrera comment configurer un projet Google Cloud et un client Web OAuth 2.0, et comment utiliser Visual Studio Code pour effectuer votre premier appel réussi à l'API Google Health.

Accéder à l'atelier de programmation

Développeur Fitbit

Si vous êtes déjà un développeur d'API Web Fitbit,vous pouvez consulter le guide de migration en premier. Il met en évidence toutes les différences entre l'API Web Fitbit et l'API Google Santé, et devrait vous fournir les conseils dont vous avez besoin pour commencer à planifier votre migration.

Ce guide présente également les bonnes pratiques et des exemples d'UI pour vous aider à guider vos utilisateurs tout au long du processus de réauthentification.

Ensuite, suivez l'atelier de programmation ou vérifiez que votre configuration Google Cloud est terminée avant de commencer le développement avec l'un de nos guides sur les types de données.

Lire le guide de migration Terminer la configuration de Google Cloud

Choisir un protocole

L'API Google Health est compatible avec les protocoles REST et RPC pour fournir aux développeurs une base évolutive et hautes performances pour l'intégration des données de santé.

REST

REST est une approche de conception d'API basée sur des concepts Web standards et des formats lisibles par l'homme tels que JSON. Il est particulièrement adapté à la création d'API publiques et d'applications Web, car il est compatible avec les navigateurs et largement pris en charge. Sa principale force réside dans sa simplicité et son accessibilité pour les développeurs externes.

gRPC

RPC est un système hautes performances qui utilise un format binaire compact appelé Protocol Buffers pour faciliter la communication entre les machines. Il est idéal pour les microservices internes, la communication entre le mobile et le backend, et les mises à jour en temps réel en raison de son efficacité et de sa prise en charge des fonctionnalités avancées comme le streaming. RPC est le choix privilégié pour les scénarios hautes performances ou lorsque des contrats d'interface stricts sont requis.

Pour en savoir plus, consultez gRPC vs REST: Understanding gRPC, OpenAPI and REST and when to use them in API design.

Ressources

En plus de vous aider à faire vos premiers pas, ce site propose des ressources complètes pour vous aider à développer et à migrer.

  • Assistance : besoin d'aide ? Accédez aux forums de la communauté et à notre outil public de suivi des problèmes sur la page d'assistance.
  • Outil de parité de l'API Google Santé : utilisez cet outil pour comparer les points de terminaison et les fonctionnalités entre l'API Web Fitbit et l'API Google Santé. Il comporte également un fichier de contexte que vous pouvez utiliser directement avec un LLM ou dans un fichier Agents.md dans votre outil d'IA préféré.
  • Documentation de référence de l'API : documentation de référence complète sur REST.