Bereiche

Für alle Google Health API-Endpunkte, mit denen Nutzerdaten gelesen und geschrieben werden, ist die Einwilligung des Nutzers in die Datenerhebung über einen oder mehrere Bereiche erforderlich. Die App muss die Liste der Bereiche beim Aufrufen des OAuth2-Authentifizierungsendpunkts von Google angeben. Weitere Informationen finden Sie unter OAuth2-Zugriffstokens abrufen. Das ausgegebene Zugriffstoken enthält nur die Bereiche, die der einwilligende Nutzer autorisiert hat.

Alle Google Health API-Bereiche beginnen mit:

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

Implementierung

Für eine optimale Nutzererfahrung und zur Einhaltung der Sicherheitsbestimmungen sollten Sie beim Anfordern von Bereichen Folgendes beachten:

  • Nur die erforderlichen Bereiche anfordern: Fordern Sie nur Zugriff auf die spezifischen Datenbereiche an, die für die Funktion Ihrer Anwendung erforderlich sind.
  • Schreibzugriff nur beim Senden von Daten konfigurieren: Konfigurieren Sie den Schreibzugriff (z. B. mit einem writeonly-Bereich) nur, wenn Sie Daten an Google Health senden.
  • Teilweise Einwilligung korrekt verarbeiten: Ihre Anwendung sollte nicht fehlschlagen, wenn ein Nutzer nicht alle auf dem Zustimmungsbildschirm angezeigten Bereiche auswählt.
    • Wenn Ihre Anwendung alle präsentierten Bereiche benötigt, können Sie den folgenden Text einblenden: „Für eine optimale Nutzererfahrung empfehlen wir, alle Bereiche zu aktivieren.“

Verfügbare Bereiche

Tabelle: Google Health API-Bereiche
Umfang Berechtigung
.activity_and_fitness.readonly Ihre Google Health-Aktivitäts- und ‑Fitnessdaten ansehen
.activity_and_fitness.writeonly Aktivitäts- und Fitnessdaten zu Google Health hinzufügen und die von der App hinzugefügten Daten bearbeiten oder löschen.
.ecg.readonly Ihre EKG‑Daten in Google Health aufrufen
.health_metrics_and_measurements.readonly Ihre Google Health-Gesundheitsmesswerte und ‑Messdaten aufrufen.
.health_metrics_and_measurements.writeonly Gesundheitsmesswerte und ‑messdaten zu Google Health hinzufügen sowie die von der App hinzugefügten Daten bearbeiten oder löschen.
.irn.readonly Ihre Google Health-Daten zu Benachrichtigungen über einen unregelmäßigen Herzrhythmus aufrufen
.location.readonly Ihren während eines Trainings aufgezeichneten Google Health-GPS-Standort aufrufen.
.nutrition.readonly Ihre Google Health-Ernährungsdaten aufrufen
.nutrition.writeonly Ernährungsdaten zu Google Health hinzufügen und die von der App hinzugefügten Daten bearbeiten oder löschen.
.profile.readonly Ihre Google Health-Profildaten ansehen.
.profile.writeonly Profildaten zu Google Health hinzufügen und die von der App hinzugefügten Daten bearbeiten oder löschen.
.settings.readonly Google Health-Einstellungen aufrufen
.settings.writeonly Einstellungsdaten zu Google Health hinzufügen und die von der App hinzugefügten Daten bearbeiten oder löschen.
.sleep.readonly Ihre Google Health-Schlafdaten ansehen.
.sleep.writeonly Schlafdaten zu Google Health hinzufügen und die von der App hinzugefügten Daten bearbeiten oder löschen.