Checklist du développeur

Cette checklist présente les étapes recommandées pour lancer votre application avec l'intégration de l'API Google Health.

1. Avant de commencer

Consultez la documentation pour les développeurs : comprenez les types de données, les champs d’application et les points de terminaison de l’API pour déterminer ceux qui sont nécessaires à votre intégration.

Consultez les règles de l'API Google Health : assurez-vous que votre cas d'utilisation est conforme aux Conditions d'utilisation pour les développeurs de l'API Google Health et au Règlement pour les développeurs et sur les données utilisateur de l'API Google Health.

Planifiez l'expérience utilisateur : si vous migrez des utilisateurs depuis l'API Fitbit Web API, consultez les bonnes pratiques du guide de migration pour gérer la réauthentification des utilisateurs.

2. Configurer votre intégration

Configurez Google Cloud : suivez les étapes de la section Configurer Google Cloud et OAuth pour créer un projet Google Cloud, activer l'API Google Health et configurer les identifiants OAuth 2.0.

Configurez l'écran de consentement OAuth : dans la console Google Cloud, configurez l' écran de consentement OAuth avec les informations de votre application, votre branding et des liens vers les règles de confidentialité et les Conditions d'utilisation de votre application.

Ajoutez des champs d'application : dans la console Google Cloud, ajoutez les champs d'application requis pour les types de données auxquels votre application doit accéder. Examinez l'implémentation des champs d'application, par exemple en ne demandant que les champs d'application nécessaires, en ne configurant l'accès en écriture que lors de l'envoi de données et en gérant correctement le consentement partiel.

3. Développer et tester

Effectuez votre premier appel d'API : si vous n'avez jamais utilisé l'API Google Health, suivez l'Codelab pour effectuer votre premier appel d'API en quelques minutes.

Migrez depuis l'API Fitbit Web : si vous migrez depuis l'API Fitbit Web, consultez le guide de migration et utilisez l'outil de parité pour comparer les API.

Implémentez OAuth 2.0 : implémentez l'autorisation OAuth 2.0 pour obtenir le consentement de l'utilisateur et les jetons d'API. Utilisez des bibliothèques clientes pour simplifier votre implémentation.

Ajoutez des utilisateurs test : lorsque votre application est en mode "Test" dans Google Cloud, ajoutez des utilisateurs test pour tester votre intégration avec des comptes figurant sur la liste d'autorisation.

Récupérez des données : utilisez les points de terminaison de type de données appropriés pour récupérer les données utilisateur. Suivez les bonnes pratiques pour récupérer les données historiques en les séparant de l'intégration, car les limites de débit sont fixes pour toutes les périodes de données.

Gérez les erreurs : consultez le guide de dépannage pour connaître les erreurs courantes et savoir comment les gérer.

Utilisez des webhooks pour les abonnements : utilisez l'API d'abonnement pour recevoir des notifications en temps réel plutôt que d'interroger. Placez les notifications entrantes dans une file d'attente et traitez-les séparément. Consultez les bonnes pratiques concernant les webhooks.

4. Préparer le lancement

Validation OAuth : si votre application doit prendre en charge plus de 100 utilisateurs ou si vous êtes prêt à la lancer publiquement, envoyez-la pour validation OAuth. Ce processus peut prendre plusieurs jours et inclut un examen de sécurité par un tiers ainsi que la validation des règles de confidentialité et des Conditions d'utilisation de votre application.

Migration de l'API Fitbit Web : si vous effectuez une migration, assurez-vous que le flux de réauthentification des utilisateurs est fluide, en suivant les recommandations du guide de migration.

5. Lancer et gérer

Publiez votre application : une fois la validation OAuth terminée, publiez votre application en mode "En production" dans la console Google Cloud pour supprimer la limite de 100 utilisateurs.

Surveillez : surveillez l'utilisation de l'API et les taux d'erreur dans la console Google Cloud.

Restez informé : consultez les notes de version pour connaître les mises à jour et les abandons d'API.