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.

API Reference

Die API-Referenz ist nach Ressourcentypen gegliedert. Jeder Ressourcentyp verfügt über eine oder mehrere Datendarstellungen und eine oder mehrere Ressourcen.

Users.dataSources

Ausführliche Informationen zu Ressourcen vom Typ "Users.dataSources" erhalten Sie auf der Seite Ressourcendarstellung.

Methode	HTTP-Anfrage	Beschreibung
Die URIs beziehen sich auf https://www.googleapis.com/fitness/v1/users, sofern nicht anders angegeben.
Erstellen	`POST /userId/dataSources`	Erstellt eine neue Datenquelle, die für alle Datenquellen dieses Nutzers eindeutig ist. Eine Datenquelle ist eine einzigartige Quelle für Sensordaten. Datenquellen können Rohdaten bereitstellen, die von Hardwaresensoren auf lokalen oder Begleitgeräten stammen. Sie können auch abgeleitete Daten verfügbar machen, die durch Transformieren oder Zusammenführen anderer Datenquellen erstellt wurden. Für denselben Datentyp können mehrere Datenquellen vorhanden sein. Jeder Datenpunkt in jedem Dataset, der in die Fitness API eingefügt oder aus dieser gelesen wird, ist mit einer Datenquelle verknüpft. Jede Datenquelle erzeugt einen eindeutigen Stream von Dataset-Aktualisierungen mit einer eindeutigen Datenquellen-ID. Nicht alle Änderungen an der Datenquelle wirken sich auf die Datenstream-ID aus. Daher können Daten, die von aktualisierten Versionen derselben Anwendung bzw. desselben Geräts erfasst werden, weiterhin zur selben Datenquelle gehören. Datenquellen werden mithilfe eines vom Server generierten Strings identifiziert, basierend auf dem Inhalt der erstellten Quelle. Das Feld `dataStreamId` sollte beim Aufrufen dieser Methode nicht festgelegt werden. Sie wird vom Server automatisch mit dem richtigen Format generiert. Wenn `dataStreamId` festgelegt ist, muss sie dem Format entsprechen, das vom Server generiert werden würde. Dieses Format ist eine Kombination aus mehreren Feldern aus der Datenquelle und hat eine bestimmte Reihenfolge. Wenn sie nicht übereinstimmt, schlägt die Anfrage fehl und ein Fehler wird angezeigt. Wenn Sie einen Datentyp angeben, der kein bekannter Typ ist (beginnend mit „com.google.“), wird eine Datenquelle mit einem benutzerdefinierten Datentyp erstellt. Benutzerdefinierte Datentypen sind nur in der Anwendung lesbar, in der sie erstellt wurden. Benutzerdefinierte Datentypen wurden eingestellt. Verwenden Sie stattdessen Standarddatentypen. Neben den Datenquellenfeldern in der Datenquellen-ID ist auch die Entwicklerprojektnummer enthalten, die beim Erstellen der Datenquelle authentifiziert wird. Diese Entwicklerprojektnummer wird verschleiert, wenn sie von einem anderen Entwickler gelesen wird, der öffentliche Datentypen liest.
delete	`DELETE /userId/dataSources/dataSourceId`	Löscht die angegebene Datenquelle. Die Anfrage schlägt fehl, wenn die Datenquelle Datenpunkte enthält.
get	`GET /userId/dataSources/dataSourceId`	Gibt die angegebene Datenquelle zurück.
list	`GET /userId/dataSources`	Listet unter Verwendung der bereitgestellten OAuth-Bereiche alle Datenquellen auf, die für den Entwickler sichtbar sind. Die Liste ist nicht vollständig. Der Nutzer kann private Datenquellen haben, die nur für andere Entwickler sichtbar sind, oder Aufrufe mit anderen Bereichen haben.
Update	`PUT /userId/dataSources/dataSourceId`	Aktualisiert die angegebene Datenquelle. Die Attribute `dataStreamId`, `dataType`, `type`, `dataStreamName` und `device` mit Ausnahme von `version` können nicht geändert werden. Datenquellen sind über ihre `dataStreamId` gekennzeichnet.

Users.dataSources.dataPointChanges

Ausführliche Informationen zu Ressourcen vom Typ "Users.dataSources.dataPointChanges" finden Sie auf der Seite Ressourcendarstellung.

Methode	HTTP-Anfrage	Beschreibung
Die URIs beziehen sich auf https://www.googleapis.com/fitness/v1/users, sofern nicht anders angegeben.
list	`GET /userId/dataSources/dataSourceId/dataPointChanges`	Abfragen des Datenpunkts des Nutzers für eine bestimmte Datenquelle ändern

Users.dataSources.datasets

Ausführliche Informationen zu Ressourcen vom Typ "Users.dataSources.datasets" erhalten Sie auf der Seite Ressourcendarstellung.

Methode	HTTP-Anfrage	Beschreibung
Die URIs beziehen sich auf https://www.googleapis.com/fitness/v1/users, sofern nicht anders angegeben.
delete	`DELETE /userId/dataSources/dataSourceId/datasets/datasetId`	Führt ein inklusives Löschen aller Datenpunkte durch, deren Start- und Endzeit sich mit dem durch die Dataset-ID angegebenen Zeitraum überschneiden. Bei den meisten Datentypen wird der gesamte Datenpunkt gelöscht. Bei Datentypen, bei denen die Zeitspanne einen konsistenten Wert darstellt (z. B. `com.google.activity.segment`), und ein Datenpunkt auf einem der Endpunkte des Datasets liegt, wird nur der sich überschneidende Teil des Datenpunkts gelöscht.
get	`GET /userId/dataSources/dataSourceId/datasets/datasetId`	Gibt ein Dataset zurück, das alle Datenpunkte enthält, deren Start- und Endzeit sich mit dem angegebenen Bereich der minimalen Start- und maximalen Endzeit des Datasets überschneiden. Insbesondere Datenpunkte, deren Startzeit kleiner oder gleich der Endzeit des Datasets ist und deren Endzeit größer oder gleich der Startzeit des Datasets ist.
patch	`PATCH /userId/dataSources/dataSourceId/datasets/datasetId`	Fügt einem Dataset Datenpunkte hinzu. Das Dataset muss nicht zuvor erstellt werden. Alle Punkte innerhalb des angegebenen Datasets werden mit nachfolgenden Aufrufen zum Abrufen dieses Datasets zurückgegeben. Datenpunkte können zu mehr als einem Dataset gehören. Diese Methode verwendet keine Patch-Semantik: Die angegebenen Datenpunkte werden nur eingefügt, ohne vorhandene Daten zu ersetzen.

Users.dataset

Ausführliche Informationen zu Ressourcen vom Typ "Users.dataset" finden Sie auf der Seite Ressourcendarstellung.

Methode	HTTP-Anfrage	Beschreibung
Die URIs beziehen sich auf https://www.googleapis.com/fitness/v1/users, sofern nicht anders angegeben.
aggregiert	`POST /userId/dataset:aggregate`	Aggregiert Daten eines bestimmten Typs oder Streams in Buckets, die durch einen bestimmten Begrenzungstyp unterteilt sind. Datasets mit verschiedenen Typen und aus mehreren Quellen können pro Anfrage zu genau einem Bucket-Typ zusammengefasst werden.

Users.sessions

Ausführliche Informationen zu Ressourcen vom Typ "Users.sessions" finden Sie auf der Seite Ressourcendarstellung.

Methode	HTTP-Anfrage	Beschreibung
Die URIs beziehen sich auf https://www.googleapis.com/fitness/v1/users, sofern nicht anders angegeben.
delete	`DELETE /userId/sessions/sessionId`	Löscht eine Sitzung, die durch die angegebene Sitzungs-ID angegeben wird.
list	`GET /userId/sessions`	Listet zuvor erstellte Sitzungen auf.
Update	`PUT /userId/sessions/sessionId`	Aktualisiert oder fügt eine bestimmte Sitzung ein.