Fit-Migrationsanleitung

Die Google Fit APIs sind veraltet und werden voraussichtlich Ende 2026 eingestellt. Google bietet verschiedene Produkte und Dienste für Gesundheit und Wohlbefinden an, mit denen Ihre Nutzer auch nach der Einstellung ihre Ziele erreichen können.

Achtung:Die Google Fit API (einschließlich der REST API) wird nur bis Ende 2026 unterstützt. Wir empfehlen, für cloudbasierte Integrationen zur Google Health API zu migrieren und für Schritt-Tracking und mobile Apps zu Health Connect.

Die folgenden Richtlinien zeigen, zu welchem Dienst Sie migrieren sollten, je nachdem, wie Sie die Google Fit APIs verwenden.

Die Auswahl der API sollte auf Ihrem Anwendungstyp und den spezifischen Datenanforderungen basieren.

Nach Anwendungstyp

App-Typ Empfohlener Pfad Hauptgrund
App zur Aufzeichnung von Schritten Health Connect Mobile-zentrierte Darstellung aggregierter Schrittdaten aus verschiedenen Quellen.
Companion-App für Fitness-Tracker Google Health API Weborientierte Plattform, die OAuth für die Nutzerintegration erfordert.
Gesundheits- und Fitnessplattform Die Google Health API und Health Connect Verwenden Sie die Google Health API für Fitbit-/Google-Gerätedaten und Health Connect für aggregierte Daten auf dem Gerät.

Nach aktueller Integration

Aktuelle Integration Empfohlener Pfad Verfügbarkeit
Google Fit (Android und REST API) Google Health API Verfügbar
Schritte auf dem Mobilgerät lesen (mit der Google Fit Recording API) Health Connect Verfügbar
Fit API unter Wear OS Gesundheitsdienste Verfügbar
Fitbit Web API Google Health API Verfügbar
Recording API auf Mobilgeräten Health Connect Verfügbar
Health Connect Bestehende Integration beibehalten oder Google Health API hinzufügen Verfügbar

Technische Vergleiche

In den folgenden Abschnitten finden Sie einen technischen Vergleich zwischen den Google Fit APIs, der Google Health API und Health Connect, der Ihnen bei der Auswahl des richtigen Migrationspfads helfen soll.

Fit API im Vergleich zur Google Health API

Verwenden Sie diesen Pfad, wenn Ihre App eine webbasierte Plattform ist oder S2S-Interaktionen (Server-zu-Server) erfordert.

Funktion Fit API (Android/REST) Google Health API
Projekt einrichten Google Cloud Console Google Cloud-Projekt erstellen
OAuth-Konfiguration Android- oder Webanwendungstyp Webanwendungstyp
Datenarchitektur Typen mit dem Präfix com.google Einheitliche Google Health API-Datentypen
App-Registrierung Google Cloud-Projekt erstellen Google Cloud-Projekt erstellen und Google Health API aktivieren

Fit API im Vergleich zu Health Connect

Verwenden Sie diesen Pfad für mobile Android-Apps, die lokale Gerätemesswerte lesen.

Funktion Fit API für Android Health Connect
Registrierung Google Cloud Console Play Store-Projekt und Erklärung zu Gesundheits-Apps
Authentifizierung OAuth 2.0 erforderlich Kein OAuth erforderlich (Geräteberechtigungen)
Datenspeicherung Cloudbasiert Geräteorientiert (auf dem Gerät)
Zielgruppe Vorherige Version (Android) Moderne Android-Entwickler
Berechtigungen OAuth-Bereiche Berechtigungen im Android-Manifest

Fit API-Integrationen

In den folgenden Abschnitten finden Sie Anleitungen zur Migration von den einzelnen Google Fit APIs. Wenn Ihre Integration auch UI-Elemente umfasst, die mit der Google Fit App verbunden sind, finden Sie in den Richtlinien für die Integration der Fit App weitere Informationen.

Apps, die die Fit Recording API zum Aufzeichnen von Schritten verwenden

Mit der Fit Recording API kann Ihre App durch das Erstellen von Abos eine automatische, akkusparende Speicherung von Sensordaten anfordern. Jedes Abo verbindet eine Android-App mit einem bestimmten Fitnessdatentyp oder einer bestimmten Datenquelle. Der Datentyp Step wird häufig zum Aufzeichnen von Schritten verwendet.

So migrieren Sie von der Fit Recording API:

Tabelle 1: Migrationsschritte von der Fit Recording API
Telefon Wear
  1. Wenn Sie eine Gesamtschrittzahl anzeigen möchten, fügen Sie Health Connect Ihrer App hinzu. Die Gesamtzahl umfasst Schritte vom Smartphone (Android 14 oder höher) und Schritte aus anderen Apps und Geräten.
  2. Wenn Sie weiterhin lokale Schrittdaten in Ihrer App anzeigen möchten, müssen Sie das Schreiben von Daten mit der Write API von Health Connect implementieren.

Health Services verwenden:

  • PassiveMonitoringClient
  • ExerciseClient

Weitere Informationen zu den Unterschieden zwischen den beiden finden Sie in der Health Services-Dokumentation.

Apps, die die History API zum Lesen oder Schreiben von Daten im Fitness Store verwenden

Mit der History API kann Ihre App Bulk-Vorgänge im Fitness Store ausführen. Zu diesen Vorgängen gehören das Lesen, Einfügen, Aktualisieren und Löschen von Gesundheits- und Wellnessdaten aus der Vergangenheit.

So migrieren Sie von der History API:

Tabelle 2: Migrationsschritte von der Fit History API
Telefon Wear

Umstellung auf die Google Health API

Nicht zutreffend Verwenden Sie Health Connect über Ihre mobile App und nicht über das Wearable.

Apps, die die Sensor API verwenden, um Fitnessdaten in Echtzeit anzuzeigen

Mit der Sensor API können Sie Rohsensordaten in Ihrer App in Echtzeit lesen. Die Sensor API bietet folgende Funktionen:

  • Listet Datenquellen auf, die auf dem Gerät und auf Companion-Geräten verfügbar sind.
  • Registriert Listener, die Rohsensordaten empfangen.
  • Hebt die Registrierung von Listenern auf, sodass sie keine Rohsensordaten mehr empfangen.

So migrieren Sie von der Sensor API:

Tabelle 3: Migrationsschritte von der Fit Sensor API
Telefon Wear

Sensoren und Fused Location Provider API verwenden

Gesundheitsdienste unter Wear OS verwenden:

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Oder verwenden Sie SensorManager, FusedLocationProvider

Apps, die die Session API verwenden, um Aktivitätszusammenfassungen bereitzustellen

Sitzungen stellen ein Zeitintervall dar, in dem Nutzer eine Fitnessaktivität ausführen.

Mit der Session API kann Ihre App Sitzungen im Fitness-Store erstellen.

So migrieren Sie von der Session API:

Tabelle 4: Migrationsschritte von der Fit Session API
Telefon Wear

Start/Stopp: Nicht zutreffend. Die Anwendung sollte den Status laufender Sitzungen intern verfolgen.

Lese-/Schreibzugriff: Umstellung auf die Google Health API

Starten/Beenden: Health Services verwenden (ExerciseClient)

Lesen/Schreiben: Health Connect mit Ihrer mobilen App verwenden

Für bestimmte Workflows empfehlen wir Folgendes:

  • Sitzung einfügen: Entwickler sollten Health Connect mit ihrer mobilen App verwenden und entweder eine ExerciseSessionRecord oder eine SleepSessionRecord einfügen.

Apps, die die Goals API verwenden

Ziele sind Vorgaben in der Google Fit App, die Nutzer für ihre Messwerte wie Schritte und Kardiopunkte festlegen können. Auf der Fit-Plattform werden die Ziele des Nutzers aufgezeichnet und seine täglichen Aktivitäten mithilfe der Goals API mit diesen verglichen.

Tabelle 5: Migrationsanleitung für die Fit Goals API
Telefon Wear
Keine Ersatz-API verfügbar. Keine Ersatz-API verfügbar.

Apps, die die BLE API verwenden

Ihre App kann verfügbare BLE-Geräte (Bluetooth Low Energy) finden und Sensordaten mithilfe der BLE API in die Google Fit-Plattform einfügen.

So migrieren Sie von der BLE API:

Tabelle 6: Migrationsschritte von der Fit BLE API
Telefon Wear
Verwenden Sie Android Bluetooth APIs direkt. Verwenden Sie Android Bluetooth APIs direkt.

Eingestellte Funktionen

Für die folgenden Funktionen gibt es keinen direkten API-Ersatz. Verwenden Sie die empfohlenen Android-Standard-APIs:

  • Sensor API: Verwenden Sie das Android Sensors-Framework oder die Fused Location Provider API für Rohdaten in Echtzeit.
  • Goals API: Es ist keine Ersatz-API verfügbar. Verwalte die Zielverfolgung und die täglichen Aktivitätsziele in deiner Anwendungslogik.
  • Bluetooth Low Energy (BLE) API: Verwenden Sie die Android Bluetooth APIs direkt, um mit der Hardware zu kommunizieren.

Fit-App-Integrationen

Wenn Ihre App eine Verbindung zu Google Fit für die gemeinsame Nutzung von Daten herstellt, folgen Sie der Anleitung zur Migration bestehender und neuer Nutzer zu Health Connect oder der Google Health API in den folgenden Abschnitten:

Vorhandene Nutzer Ihrer App

Wenn die Benutzeroberfläche Ihrer App eine Möglichkeit für Nutzer bietet, eine Verbindung zu Google Fit herzustellen, oder wenn Ihre App in der Liste der Apps, die mit Google Fit kompatibel sind, enthalten ist, können Sie die Fit App-Integration für aktuelle Nutzer weiterhin aufrechterhalten.

Wir werden diesen Abschnitt regelmäßig aktualisieren und Informationen dazu bereitstellen, wann Sie die Fit App-Integration einstellen sollten und welche Optionen Sie haben, um die Nutzerfreundlichkeit zu erhalten. In der Zwischenzeit können Sie Kontakt mit uns aufnehmen.

Tabelle 7: Empfehlungen für bestehende Nutzer mit Google Fit-App-Integrationen
checkSo gehts SchließenNicht erlaubt
Bieten Sie Health Connect oder die Google Health API als neue Option in Ihrer App an.

Konzentrieren Sie sich auf die Vorteile für Nutzer, z. B. umfangreichere Daten und Statistiken, Datenschutz und Sicherheit.

Mit Health Connect synchronisieren

Bitte die Nutzer, die Verbindung zu Google Fit zu trennen.

Verbindung mit Health Connect aufheben

Neue Nutzer Ihrer App

Damit neue Nutzer Ihrer App eine ähnliche Erfahrung machen können, empfehlen wir, eine Integration mit Health Connect oder der Google Health API zu entwickeln.

Health Connect bietet Zugriff auf neue Datenquellen und ‑typen, um Nutzern eine bessere Erfahrung zu ermöglichen. Die Daten werden sicher auf dem Gerät gespeichert. Die Google Health API bietet eine webzentrierte Plattform für Daten von Fitbit- und Google-Geräten.

Tabelle 8: Empfehlungen für neue Nutzer mit Fit App-Integrationen
checkSo gehts SchließenNicht erlaubt
Binde Health Connect oder die Google Health API in den Einrichtungsvorgang deiner App ein. Bieten Sie Fit als App an, die Nutzer verbinden können, sobald Health Connect verfügbar ist.