Google Health API

Die Fitbit Web API wurde verbessert und modernisiert, um eine standardisierte, konsistente und skalierbare Grundlage für Entwicklerintegrationen zu bieten. Sie heißt jetzt Google Health API. Die Google Health API ist die strategische Weiterentwicklung der alten Fitbit Web API und wurde von Grund auf auf der modernen Infrastruktur von Google neu entwickelt.

Mit dieser Plattform erhalten Entwickler Zugriff auf die gesamte Leistungsfähigkeit der Google Cloud-Entwicklertools und die Möglichkeit, ihre Berechtigungen über Google OAuth 2.0 zu verwalten.

Was bietet die Google Health API?

  • Einheitliche Datenquelle: Unser neuer „Reconciled Stream“ übernimmt die komplexe Aufgabe, sich überschneidende Datenpunkte aus mehreren Quellen abzugleichen. So wird sichergestellt, dass Apps dieselben konsistenten Daten anzeigen, die Nutzer in der Fitbit App sehen. Dieser Stream wird zusätzlich zu unserem Erstanbieter-Stream bereitgestellt, der Daten von Fitbit- und Pixel-Geräten sowie manuelle Einträge enthält.
  • Technische Modernisierung und Leistung: Wir haben über 100 Legacy-Endpunkte zu einer optimierten Gruppe vereinfachter Datentyp-Bundles zusammengefasst und Inkonsistenzen bei Datenformaten, Zeitzonen, Maßeinheiten und Fehlerbehandlung beseitigt. Außerdem unterstützen wir jetzt das HTTP/REST-Protokoll für den leistungsstarken Datenabruf. Außerdem sind Intraday-Daten und Webhooks jetzt für alle relevanten Datentypen über einen dedizierten Listenendpunkt verfügbar.
  • Erweiterte Webhooks und Skalierbarkeit: Du profitierst von einer erweiterten Webhook-Unterstützung, einschließlich automatischer Abos und detaillierter Verwaltung für alle relevanten Datentypen, die mit der nächsten Generation von KI-gestützten Gesundheits-Apps skalierbar sind.
  • Optimierte Identität und Sicherheit: Ersetze die alte Fitbit-Autorisierung (FOT) durch Google OAuth 2.0. So können Entwickler Standard-Authentifizierungsbibliotheken von Google verwenden, was die Codebasis vereinfacht und Nutzern eine vertraute, zentrale Möglichkeit bietet, ihre Berechtigungen zu verwalten. Alle Google Health API-Bereiche sind als „Eingeschränkt“ kategorisiert. Für den Zugriff ist eine Datenschutz- und Sicherheitsüberprüfung erforderlich.

Sind Sie mit den Vorschlägen zufrieden? Jetzt loslegen

API-Versionen und die öffentliche Betaversion

Die Google Health API verwendet eine kanalbasierte Versionsverwaltung gemäß den API-Verbesserungsvorschlägen (AIPs) von Google, insbesondere AIP-185: API-Versionsverwaltung und AIP-181: Stabilitätsstufen. Die API ist über zwei öffentliche Kanäle verfügbar: den stabilen v4-Kanal und den öffentlichen Beta-v4beta-Kanal. Google unterstützt beide Kanäle über die Standard-Supportkanäle.

Stabile Version und Betaversion vergleichen

Gemäß AIP-185 fungiert der v4beta-Kanal als Superset des stabilen v4-Kanals. Sie enthält alle stabilen v4-Funktionen sowie Datentypen, Felder und Methoden mit Vorabzugriff, die von Partnern getestet werden.

In der Dokumentation sind API-Elemente, die nur in der Betaversion verfügbar sind, mit dem Label v4beta gekennzeichnet.

Funktion Stable Channel (v4) Öffentliche Betaversion (v4beta)
REST-Basis-URI https://health.googleapis.com/v4 https://health.googleapis.com/v4beta
gRPC-Paket google.devicesandservices.health.v4 google.devicesandservices.health.v4beta
Referenzdokumente v4 REST und v4 RPC v4beta REST und v4beta RPC
Stabilitätsstufe Produktionsreif und unterliegt den AIP-180-Regeln für die Abwärtskompatibilität. Instabile Vorabversion, die jederzeit ohne Vorankündigung inkompatibel geändert oder entfernt werden kann.
Verwendungszweck Live-Produktionsanwendungen für Nutzer. Frühe Tests, Prototyping, Schemavalidierung und Feedback von Entwicklern.
Support Unterstützung über die Standard-Supportkanäle. Unterstützung über die standardmäßigen Supportkanäle für Fehlerberichte, Fehlerbehebung und Designfeedback.

Umgang mit dem v4beta-Kanal

Beachten Sie beim Erkunden von Funktionen, die mit v4beta gekennzeichnet sind, die folgenden Richtlinien:

  • Verwenden Sie v4beta hauptsächlich in Entwicklungs-, Staging- und Nicht-Produktions-Testumgebungen. Es wird nicht empfohlen, Produktionsfunktionen bereitzustellen, die von v4beta-Endpunkten oder reinen Beta-Datentypen abhängen.
  • Schemas, Feldnamen, Endpunktverhalten und Datendarstellungen in v4beta können sich ohne Vorwarnung ändern. Betafunktionen und ‑datentypen können auch vollständig entfernt werden, wenn sie die Validierungsziele nicht erfüllen.
  • Isolieren Sie experimentellen v4beta-Clientcode hinter Funktions-Flags oder separaten Modulen, damit funktionsgefährdende Änderungen in der Betaversion Ihre v4-Kernintegration nicht beeinträchtigen.
  • Über unsere Standard-Supportkanäle können Sie Support erhalten, Probleme melden und Feedback zur Implementierung von v4beta geben, um das endgültige API-Design mitzugestalten.

Hochstufung von v4beta auf stabile v4

Neue Datentypen und Funktionen werden in v4beta eingeführt, um Partnern das Testen und die Marktvalidierung zu ermöglichen, bevor sie in die stabile v4-Version aufgenommen werden.

Google bewertet Betafunktionen anhand der folgenden Kriterien, bevor sie auf v4 hochgestuft werden:

  • Durch Tests mit Partnern wird bestätigt, dass das Datenmodell, die Feldsemantik und die Abfragemuster den Anforderungen realer Anwendungen entsprechen.
  • Das Entwicklerfeedback und die Designüberprüfungen sind abgeschlossen und das Schema kann gemäß den Garantien für die Abwärtskompatibilität von AIP-180 gesperrt werden.
  • End-to-End-Datenpipelines, Gerätesynchronisierung und Dienstzuverlässigkeit entsprechen den Standards für die Produktionsqualität.
  • Gemäß den AIP-185-Regeln für die Einstellung werden alle Felder oder Verhaltensweisen, die während des Betatests eingestellt wurden, entfernt, anstatt auf v4 hochgestuft zu werden.

AIP-181 bietet zwar eine allgemeine Faustregel von etwa 90 Tagen für die Beta-Bewertung, der tatsächliche Zeitpunkt für die Hochstufung eines Features von v4beta auf v4 hängt jedoch von der Komplexität des Features, der Hardwareverfügbarkeit und dem Validierungsfeedback ab. Einige Funktionen werden möglicherweise früher veröffentlicht, während andere länger in v4beta bleiben oder eingestellt werden.

Wenn ein Datentyp oder ein Feature in die stabile v4-Version hochgestuft wird, kündigt Google die Hochstufung in den Versionshinweisen an. Aktualisieren Sie dann Ihre Anfragen von https://health.googleapis.com/v4beta auf https://health.googleapis.com/v4, bevor Sie die Integration für Produktionsnutzer veröffentlichen.

Was ist mit der Fitbit Web API?

Die alte Fitbit Web API wurde gemäß dem folgenden Zeitplan eingestellt:

  • 30. September 2026 (Ende des Supports): Der Support für die Fitbit Web API wurde eingestellt und Google behebt keine Fehler mehr und bietet keinen API-Support mehr an.
  • 2. November 2026 (API-Abschaltung): Die Fitbit Web API und die Fitbit OAuth-Endpunkte wurden abgeschaltet und funktionieren nicht mehr. Es werden keine Daten mehr mit Google Health-Nutzern synchronisiert. Anfragen an diese Endpunkte schlagen fehl und geben den HTTP-Statuscode 410 Gone zurück.

Entwickler, die die alte Fitbit Web API und die Fitbit-Autorisierung verwenden, sollten ihre Anwendungen und Nutzer zur Google Health API und zu Google OAuth 2.0 migrieren.

Weitere Informationen finden Sie in der Migrationsanleitung.

Welche Geräte werden unterstützt?

Alle aktuellen und früheren Fitbit-Geräte und Google Pixel Watches erfassen Daten, die über die Google Health API zurückgegeben werden. Die Art der verfügbaren Daten hängt von den Funktionen ab, die die Geräte unterstützen.

Eine Liste der aktuellen Geräte findest du im Google Store.

Wie kann ich Feedback geben?

Ihr Feedback ist uns sehr wichtig. Wir freuen uns über Ihr Feedback, das Sie uns über die Supportkanäle auf der Supportseite senden können.

Wir haben uns zwar große Mühe gegeben, diese APIs so zu gestalten, dass sie dich gut unterstützen, aber die Google Health API wird aktiv weiterentwickelt. Bitte beachten Sie, dass wir aufgrund Ihres Feedbacks möglicherweise bis Ende Mai Änderungen vornehmen, die entsprechende Aktualisierungen Ihrerseits erfordern.

Roadmap

Dies ist eine Liste der Funktionen, die 2026 eingeführt werden.

4. Quartal 2026

Datentypen (Lesen und Schreiben)

  • Detaillierte Hauttemperatur
  • Grundumsatz
  • Wir werden Datentypen hinzufügen, um die Parität mit Health Connect zu erreichen. Im 4. Quartal 2026 und im 1. Quartal 2027 werden voraussichtlich viele weitere Health Connect-Datentypen hinzugefügt.

Funktionen

  • Öffentlicher Betakanal für Vorabzugriff auf neue Datentypen
  • Statistikendpunkt zum Überwachen der Webhook-Telemetrie