Die API-Referenz ist nach Ressourcentypen gegliedert. Jeder Ressourcentyp verfügt über eine oder mehrere Datendarstellungen und eine oder mehrere Ressourcen.
Ressourcentypen
- Users.dataSources
- Users.dataSources.dataPointChanges
- Users.dataSources.dataset
- Users.dataset
- Nutzer.sessions
Nutzer.Datenquellen
Ausführliche Informationen zu Ressourcen vom Typ „Users.dataSources“ finden Sie auf der Seite Ressourcendarstellung.
| Methode | HTTP-Anfrage | Beschreibung |
|---|---|---|
| URIs in Bezug 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 eindeutige Sensordatenquelle. Datenquellen können Rohdaten von Hardwaresensoren auf lokalen oder Companion-Geräten offenlegen. Sie können auch abgeleitete Daten verfügbar machen, die durch die Transformation oder Zusammenführung anderer Datenquellen erstellt wurden. Für denselben Datentyp können mehrere Datenquellen vorhanden sein. Jedem Datenpunkt in jedem Dataset, das in die Fitness API eingefügt oder daraus gelesen wird, ist eine Datenquelle zugeordnet. 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, sodass Daten, die von aktualisierten Versionen derselben Anwendung oder desselben Geräts erhoben werden, weiterhin als zur selben Datenquelle gehörend betrachtet werden können. Datenquellen werden anhand eines vom Server generierten Strings basierend auf dem Inhalt der erstellten Quelle identifiziert. Das Feld dataStreamId sollte beim Aufrufen dieser Methode nicht festgelegt werden. Er wird vom Server automatisch mit dem richtigen Format generiert. Wenn ein dataStreamId festgelegt ist, muss er dem Format entsprechen, das der Server generieren würde. Dieses Format ist eine Kombination aus einigen Feldern aus der Datenquelle und hat eine bestimmte Reihenfolge. Stimmt die Anfrage nicht überein, schlägt die Anfrage fehl.
Wenn Sie einen unbekannten Datentyp angeben (beginnend mit „"com.google."“), wird eine Datenquelle mit einem benutzerdefinierten Datentyp erstellt. Benutzerdefinierte Datentypen sind nur für die Anwendung lesbar, die sie erstellt hat. Benutzerdefinierte Datentypen wurden verworfen. Verwenden Sie stattdessen Standarddatentypen. Zusätzlich zu den Datenquellenfeldern, die in der Datenquellen-ID enthalten sind, ist auch die Entwicklerprojektnummer enthalten, die beim Erstellen der Datenquelle authentifiziert ist. Diese Entwicklerprojektnummer ist verschleiert, wenn sie von anderen Entwicklern gelesen wird, die öffentliche Datentypen lesen. |
| Delete |
DELETE /userId/dataSources/dataSourceId
|
Die angegebene Datenquelle wird gelöscht. Die Anfrage schlägt fehl, wenn die Datenquelle Datenpunkte enthält. |
| Holen Sie sich |
GET /userId/dataSources/dataSourceId
|
Gibt die angegebene Datenquelle zurück. |
| list |
GET /userId/dataSources
|
Listet alle Datenquellen auf, die für den Entwickler sichtbar sind. Dazu werden die bereitgestellten OAuth-Bereiche verwendet. Die Liste ist nicht vollständig. Der Nutzer hat möglicherweise private Datenquellen, die nur für andere Entwickler sichtbar sind, oder Aufrufe über andere Bereiche. |
| Aktualisieren |
PUT /userId/dataSources/dataSourceId
|
Die angegebene Datenquelle wird aktualisiert. Die Attribute dataStreamId, dataType, type, dataStreamName und device mit Ausnahme von version können nicht geändert werden.
Datenquellen werden anhand ihrer dataStreamId identifiziert.
|
Users.dataSources.dataPointChanges
Ausführliche Informationen zu Ressourcen vom Typ „Users.dataSources.dataPointChanges“ finden Sie auf der Seite Ressourcendarstellung.
| Methode | HTTP-Anfrage | Beschreibung |
|---|---|---|
| URIs in Bezug auf https://www.googleapis.com/fitness/v1/users, sofern nicht anders angegeben | ||
| list |
GET /userId/dataSources/dataSourceId/dataPointChanges
|
Abfragen nach den Datenpunkten des Nutzers für eine bestimmte Datenquelle. |
Users.dataSources.dataset
Ausführliche Informationen zu Ressourcen vom Typ „Users.dataSources.dataset“ finden Sie auf der Seite Ressourcendarstellung.
| Methode | HTTP-Anfrage | Beschreibung |
|---|---|---|
| URIs in Bezug 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 Endzeiten sich mit dem Zeitraum überschneiden, der durch die Dataset-ID angegeben ist. Bei den meisten Datentypen wird der gesamte Datenpunkt gelöscht. Bei Datentypen, bei denen der Zeitraum einen konsistenten Wert darstellt (z. B. com.google.activity.segment) und sich ein Datenpunkt über einen beliebigen Endpunkt des Datasets erstreckt, wird nur der überlappende Teil des Datenpunkts gelöscht.
|
| Holen Sie sich |
GET /userId/dataSources/dataSourceId/datasets/datasetId
|
Gibt ein Dataset zurück, das alle Datenpunkte enthält, deren Start- und Endzeiten sich mit dem angegebenen Bereich der minimalen und maximalen Endzeit des Datasets überschneiden. Genauer gesagt: Jeder Datenpunkt, dessen Startzeit kleiner oder gleich der Dataset-Endzeit ist und dessen Endzeit größer oder gleich der Dataset-Startzeit 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 bereitgestellten Datenpunkte werden nur eingefügt und keine vorhandenen Daten ersetzt. |
Nutzer.Dataset
Ausführliche Informationen zu Ressourcen vom Typ „Users.dataset“ finden Sie auf der Seite Ressourcendarstellung.
| Methode | HTTP-Anfrage | Beschreibung |
|---|---|---|
| URIs in Bezug auf https://www.googleapis.com/fitness/v1/users, sofern nicht anders angegeben | ||
| Zusammengefasste Werte |
POST /userId/dataset:aggregate
|
Aggregiert Daten eines bestimmten Typs oder Streams in Buckets, geteilt durch einen bestimmten Begrenzungstyp. Mehrere Datensätze aus mehreren Typen und aus mehreren Quellen können pro Anfrage in genau einem Bucket-Typ zusammengefasst werden. |
Nutzersitzungen
Ausführliche Informationen zu Ressourcen vom Typ „Users.sessions“ finden Sie auf der Seite Ressourcendarstellung.
| Methode | HTTP-Anfrage | Beschreibung |
|---|---|---|
| URIs in Bezug 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 wurde. |
| list |
GET /userId/sessions
|
Listet Sitzungen auf, die zuvor erstellt wurden. |
| Aktualisieren |
PUT /userId/sessions/sessionId
|
Aktualisiert oder fügt eine bestimmte Sitzung ein. |