Die Google Fit APIs, einschließlich der Google Fit REST API, werden 2026 eingestellt. Seit dem 1. Mai 2024 können sich Entwickler nicht mehr für die Verwendung dieser APIs registrieren.

Wir empfehlen, für cloudbasierte Integrationen zur Google Health API und für Schritt-Tracking und mobile Android-Apps zur Health Connect API zu migrieren. Eine Anleitung dazu, zu welcher API oder Plattform Sie migrieren sollten, finden Sie in der Migrationsanleitung für Fit.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Erste Schritte mit Android

In diesem Leitfaden wird erläutert, wie Sie mit der Entwicklung mit Google Fit für Android beginnen.

Einrichtung

Führen Sie die Schritte in den folgenden Abschnitten aus, bevor Sie mit der Entwicklung Ihrer App beginnen.

Einrichten eines Google-Kontos

Wenn Sie die Google Fit APIs verwenden möchten, benötigen Sie ein Google-Konto. Sie können ein neues Konto erstellen oder ein vorhandenes Konto verwenden. Möglicherweise möchten Sie ein separates Konto erstellen, um Ihre App aus der Perspektive eines Nutzers zu testen.

Google Play-Dienste installieren

Rufen Sie die neueste Clientbibliothek für Google Play-Dienste auf Ihrem Entwicklungshost ab:

Öffnen Sie den Android SDK-Manager.
Suchen Sie unter SDK Tools nach Google Play-Dienste.
Wenn der Status für diese Pakete nicht Installiert lautet, wählen Sie beide aus und klicken Sie auf Pakete installieren.

OAuth 2.0-Client-ID abrufen

Wenn Sie die Fitness API aktivieren möchten, fordern Sie eine OAuth 2.0-Client-ID an.

Projekt erstellen und konfigurieren

Wir empfehlen, die Android Studio-Entwicklungsumgebung zu verwenden, um eine App mit der Fitness API zu erstellen. Weitere Informationen zum Erstellen und Konfigurieren eines neuen Projekts in Android Studio finden Sie unter Projekt erstellen.

Google Play-Dienste-Clientbibliothek hinzufügen

Öffnen Sie in Android Studio die Datei build.gradle für Ihr Modul und fügen Sie die Clientbibliothek für Google Play-Dienste als Abhängigkeit hinzu:

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
}

So wird das Fitness SDK beim Erstellen der App automatisch von Gradle heruntergeladen.

App erstellen und testen

Nachdem Sie die Einrichtungsschritte abgeschlossen haben, können Sie mit der Entwicklung Ihrer App beginnen. Informieren Sie sich zuerst über die Datentypen, die Ihre App speichern und lesen kann. Weitere Informationen zur Verwendung von Daten in Google Fit

Erforderliche Android-Berechtigungen abrufen

Zum Lesen und Schreiben bestimmter Datentypen muss Ihre App Android-Berechtigungen anfordern.

OAuth-Berechtigungen abrufen

Die Datentypen, auf die Ihre App zugreifen darf, entsprechen den Autorisierungsbereichen. Wenn Sie diese Berechtigungen anfordern möchten, müssen Sie in einer FitnessOptions -Instanz angeben , auf welche Datentypen Ihre App Zugriff benötigt. Wenn deine App einen der Google Fit-Datentypen verwenden möchte, prüft das Android SDK automatisch, zu welchen Bereichen sie gehören, und bittet den Nutzer um die Autorisierung dieser Bereiche.

API-Client erstellen

Erstellen Sie einen API-Client und fügen Sie die Datentypen hinzu, auf die Ihre App zugreifen muss, um Daten zu schreiben oder zu lesen. Die folgenden Endpunkte sind verfügbar:

SensorsClient: Zugriff auf verschiedene Quellen für Gesundheits- und Fitnessdaten von Hardwaresensoren auf dem lokalen Gerät und auf Companion-Geräten.
RecordingClient: Für die energiesparende, always-on Erfassung von Sensordaten im Hintergrund.
HistoryClient: Verlaufsdaten in Google Fit einfügen, löschen und lesen.
SessionsClient: Sitzungen mit Nutzeraktivitäten erstellen und verwalten.
GoalsClient: Von Nutzern in Google Fit erstellte Ziele für Kardiopunkte und Schritte lesen.
ConfigClient: Zugriff auf benutzerdefinierte Datentypen und Einstellungen auf der Google Fit-Plattform.

Beispiel für die Erstellung eines Fitness API-Clients

Resultierender Nutzerautorisierungsablauf

Im Folgenden wird der resultierende Autorisierungsablauf dargestellt, den Nutzer sehen, wenn sie um Berechtigungen gebeten werden:

**Abbildung 1.**Der Autorisierungsablauf für Nutzer.

Android-Berechtigungen: Nutzer sehen vor dem Herunterladen, welche Android-Berechtigungen deine App angefordert hat. Nachdem Ihre App heruntergeladen wurde, fordert sie alle erforderlichen Laufzeitberechtigungen an und Nutzer können diese Berechtigungen erteilen oder ablehnen.
Prüfen und verbinden: Ihre App prüft, ob Berechtigungen erteilt wurden, bevor sie Zugriff auf andere Datentypen anfordert.
Anfrage für OAuth-Bereiche: Google fordert den Nutzer auf, Ihrer App die OAuth-Bereiche zu gewähren, die für die Datentypen erforderlich sind, auf die sie zugreifen möchte.
Zugriff angewendet: Nachdem der Nutzer die Berechtigungen erteilt hat, kann Ihre App auf die Datentypen zugreifen, die zu den Bereichen gehören, für die der Nutzer die Berechtigung erteilt hat.

Überprüfung beantragen

Nachdem Sie Ihre App erstellt und getestet haben, müssen Sie eine Überprüfung beantragen. Je nach vertraulichen und eingeschränkten Bereichen sind unterschiedliche Begründungen erforderlich.