Die Google Fit APIs, einschließlich der Google Fit REST API, sind nach dem 30. Juni 2025 nicht mehr verfügbar. Seit dem 1. Mai 2024 können sich Entwickler nicht mehr für die Nutzung dieser APIs registrieren.

Eine Anleitung dazu, zu welcher API oder Plattform Sie migrieren müssen, finden Sie im Health Connect-Migrationsleitfaden. Einen Vergleich von Health Connect mit den Google Fit APIs und den Fitbit Web APIs findest du im Health Connect-Vergleichsleitfaden.

Weitere Informationen zu Health Connect und zur Integration in die API

Diese Seite wurde von der Cloud Translation API übersetzt.

Erste Schritte mit Android

In diesem Leitfaden erfahren Sie, wie Sie mit Google Fit auf Android-Geräten mit der Entwicklung beginnen.

Einrichtung

Bevor Sie mit dem Erstellen Ihrer App beginnen, führen Sie die folgenden Schritte aus: .

Erstellen Sie sich ein Google-Konto

Zur Nutzung der Google Fit APIs benötigen Sie ein Google-Konto. Sie können ein neues Konto erstellen oder ein bestehendes Konto zu verwenden. Es empfiehlt sich, zum Testen ein separates Konto zu erstellen. für Ihre App aus der Perspektive der Nutzer.

Google Play-Dienste installieren

Hol dir die aktuelle Clientbibliothek für Google Play-Dienste bei deiner Entwicklung Host:

Öffnen Sie den Android SDK Manager.
Suchen Sie unter SDK-Tools nach Google Play-Dienste.
Wenn der Status dieser Pakete nicht Installiert ist, wählen Sie beide aus und klicken Sie auf Install Packages (Pakete installieren).

OAuth 2.0-Client-ID abrufen

Um die Fitness API zu aktivieren, rufen Sie eine OAuth-2.0-Client-ID ab.

Projekt erstellen und konfigurieren

Wir empfehlen, zum Erstellen einer App mit der Fitness API die Android Studio-Entwicklungsumgebung zu verwenden. Für wie Sie ein neues Projekt erstellen und in Android Studio konfigurieren, siehe Projekt erstellen

Clientbibliothek für Google Play-Dienste hinzufügen

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

Kotlin-DSL

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

...

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

Grooviges DSL

apply plugin: 'com.android.application'

...

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

Dadurch wird das Fitness-SDK automatisch von Gradle heruntergeladen, für die Entwicklung Ihrer App.

Anwendung erstellen und testen

Nachdem Sie die Einrichtung abgeschlossen haben, können Sie mit der Erstellung Ihrer App beginnen. Um Informationen zu den Datentypen, die Ihre App speichern und speichern kann lesen. Weitere Informationen zur Arbeit mit in Google Fit.

Erforderliche Android-Berechtigungen erhalten

Damit Sie einige Datentypen lesen und schreiben können, muss Ihre App Android-Berechtigungen anfordern.

OAuth-Berechtigungen abrufen

Die Datentypen, auf die deine App zugreifen darf, entsprechen denen von Autorisierungsbereiche. Fragen für diese Berechtigungen müssen Sie Hinzufügen auf welche Datentypen deine App in einem FitnessOptions zugreifen muss Instanz. Wenn Ihre App anfordert, Google Fit-Daten zu verwenden Typen überprüft, prüft das Android SDK automatisch, zu welchen Bereichen sie gehören, und fragt den Nutzer zur Autorisierung für diese Bereiche.

API-Client erstellen

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

SensorsClient: Über Hardwaresensoren des lokalen Geräts und der Companion-Geräte können Sie auf verschiedene Quellen von Gesundheits- und Fitnessdaten zugreifen.
RecordingClient: Für die Erfassung von Sensordaten im Hintergrund mit geringem Stromverbrauch.
HistoryClient: Hier können Sie Verlaufsdaten einfügen, löschen und lesen in Google Fit
SessionsClient: Hier können Sie Sitzungen mit Nutzeraktivitäten erstellen und verwalten.
GoalsClient: Hier können Sie die von Nutzern in Google Fit erstellten Kardiopunkt- und Schrittziele lesen.
ConfigClient: Auf der Google Fit-Plattform können Sie auf benutzerdefinierte Datentypen und Einstellungen zugreifen.

Sehen Sie sich ein Beispiel zum Erstellen eines Fitness API-Clients an.

Daraus resultierender Ablauf der Nutzerautorisierung

Hier sehen Sie den resultierenden Autorisierungsablauf für die Nutzer: wenn sie nach Berechtigungen gefragt werden:

**Abbildung 1**: Autorisierungsvorgang für Nutzer

Android-Berechtigungen: Nutzer sehen, welche Android-Berechtigungen die App hat. die Sie vor dem Download angefordert haben. Nachdem Ihre App heruntergeladen wurde, fordert alle benötigten Laufzeitberechtigungen an und Nutzer gewähren oder verweigern für diese Berechtigungen.
Prüfen und verbinden: Ihre App prüft, ob Berechtigungen gewährt, bevor Zugriff auf andere Datentypen angefordert wird.
Anfrage für OAuth-Bereiche: Google fordert den Nutzer dazu auf, Ihrer App zuzustimmen. OAuth-Bereiche, die für die Datentypen erforderlich sind, auf die zugegriffen werden soll.
Zugriff angewendet: Nachdem ein Nutzer Berechtigungen erteilt hat, kann Ihre App Auf die Datentypen zugreifen, die zu den Bereichen gehören, die der Nutzer gewährt hat Berechtigung erteilen.

Überprüfung beantragen

Nachdem Sie Ihre App erstellt und getestet haben, beantragen Sie Bestätigung mit unterschiedlichen Begründungen, die für Vertrauliche und eingeschränkte Bereiche: