Champs d'application

Tous les points de terminaison de l'API Google Health qui lisent et écrivent des données utilisateur nécessitent le consentement de l'utilisateur pour la collecte de ces données via un ou plusieurs niveaux d'accès. L'application doit fournir la liste des champs d'application lorsqu'elle appelle le point de terminaison d'authentification OAuth2 de Google. Consultez Obtenir des jetons d'accès OAuth2. Le jeton d'accès émis ne contient que les niveaux d'accès autorisés par l'utilisateur.

Tous les niveaux d'accès aux API Google Health commencent par :

https://www.googleapis.com/auth/googlehealth

Implémentation

Pour offrir la meilleure expérience utilisateur possible et garantir la conformité en termes de sécurité, lorsque vous demandez des autorisations, vous devez :

  • Ne demandez que les niveaux d'accès nécessaires : ne demandez l'accès qu'aux niveaux d'accès aux données spécifiques dont votre application a besoin pour fonctionner.
  • Configurer l'accès en écriture uniquement lors de l'envoi de données : ne configurez l'accès en écriture (par exemple, à l'aide d'un champ writeonly) que si vous envoyez des données à Google Santé.
  • Gérez correctement le consentement partiel : votre application ne doit pas échouer si un utilisateur ne sélectionne pas tous les niveaux présentés sur l'écran de consentement.
    • Si votre application nécessite que tous les niveaux d'accès présentés soient activés pour fonctionner, vous pouvez afficher le texte suivant : "Pour une expérience utilisateur optimale, nous vous recommandons d'activer tous les niveaux d'accès."

Champs d'application disponibles

Tableau : Niveaux d'accès de l'API Google Health
Champ d'application Autorisation
.activity_and_fitness.readonly Consultez vos données d'activité et de fitness Google Health.
.activity_and_fitness.writeonly Ajouter des données d'activité et de remise en forme à Google Health, et modifier ou supprimer ces données
.ecg.readonly Consultez vos données ECG Google Health.
.health_metrics_and_measurements.readonly Consulter vos données de mesure et vos indicateurs de santé Google Health
.health_metrics_and_measurements.writeonly Ajouter des données de mesure et des indicateurs de santé à Google Health, et modifier ou supprimer ces données
.irn.readonly Consultez vos données de notifications de rythme irrégulier Google Health.
.location.readonly Consulter votre position GPS Google Health enregistrée pendant un exercice
.nutrition.readonly Consultez vos données nutritionnelles Google Health.
.nutrition.writeonly Ajouter des données nutritionnelles à Google Health, et modifier ou supprimer ces données
.profile.readonly Consultez les données de votre profil Google Health.
.profile.writeonly Ajouter des données de profil à Google Health, et modifier ou supprimer ces données
.settings.readonly Consultez vos paramètres Google Health.
.settings.writeonly Ajouter des données de paramètres à Google Health, et modifier ou supprimer ces données
.sleep.readonly Consultez vos données sur le sommeil Google Health.
.sleep.writeonly Ajouter des données sur le sommeil à Google Health, et modifier ou supprimer ces données