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.
Jetzt ausprobieren
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/fitness/v1/users/userId/dataSources
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
userId |
string |
Erstellen Sie die Datenquelle für die identifizierte Person. Verwenden Sie me , um den authentifizierten Nutzer anzugeben. Derzeit wird nur me unterstützt.
|
Autorisierung
Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
Umfang |
---|
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Geben Sie im Anfragetext eine Users.dataSources-Ressource mit den folgenden Properties an:
Attributname | Wert | Beschreibung | Hinweise |
---|---|---|---|
Erforderliche Properties | |||
application |
nested object |
Informationen zu einer Anwendung, die Sensordaten an die Plattform sendet. | |
application.name |
string |
Der Name dieser Anwendung. Dies ist für REST-Clients erforderlich. Die Eindeutigkeit dieses Namens wird jedoch nicht erzwungen. Sie ist nur für Nutzer gedacht, die wissen möchten, über welche REST-Anwendung eine Anwendung oder Datenquelle erstellt wurde. | |
dataType |
nested object |
Der Datentyp definiert das Schema eines Datenstroms, der von der Fitness API erfasst, dort eingefügt oder abgefragt wird. | |
dataType.field[] |
list |
Ein Feld stellt eine Dimension eines Datentyps dar. | |
dataType.field[].format |
string |
Die verschiedenen unterstützten Formate für jedes Feld in einem Datentyp.
Zulässige Werte:
|
|
dataType.field[].name |
string |
Definiert den Namen und das Format der Daten. Im Gegensatz zu Namen von Datentypen sind Feldnamen nicht mit einem Namespace versehen und müssen nur innerhalb des Datentyps eindeutig sein. | |
dataType.name |
string |
Jeder Datentyp hat einen eindeutigen Namespace-Namen. Alle Datentypen im com.google-Namespace werden als Teil der Plattform freigegeben. | |
device |
nested object |
Darstellung eines integrierten Geräts, z. B. eines Smartphones oder eines Wearables, das Sensoren enthält. | |
device.manufacturer |
string |
Hersteller des Produkts bzw. der Hardware. | |
device.model |
string |
Für Endnutzer sichtbarer Modellname für das Gerät. | |
device.type |
string |
Eine Konstante, die den Typ des Geräts darstellt.
Zulässige Werte:
|
|
device.uid |
string |
Die Seriennummer oder eine andere eindeutige ID für die Hardware. Dieses Feld wird verschleiert, wenn es von einem REST- oder Android-Client gelesen wird, der die Datenquelle nicht erstellt hat. Nur der Ersteller der Datenquelle sieht das UID-Feld klar und normal. Die Verschleierung sorgt für Gleichheit, d. h., es werden zwei IDs angegeben: id1 == id2, obfuscated(id1) == obfuscated(id2). |
|
device.version |
string |
Versionsstring für die Hardware/Software des Geräts. | |
type |
string |
Eine Konstante, die den Typ dieser Datenquelle beschreibt. Gibt an, ob diese Datenquelle Roh- oder abgeleitete Daten erzeugt.
Zulässige Werte:
|
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource „Users.dataSources“ im Antworttext zurückgegeben.
Testen!
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.