Users.dataSources: create

Hinweis:Hierfür ist eine Autorisierung erforderlich.

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. 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:

Bereich
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 Ressource vom Typ „Users.dataSources“ mit den folgenden Attributen an:

Property-Name	Wert	Beschreibung	Hinweise
Erforderliche Eigenschaften
application	nested object	Informationen zu einer Anwendung, die Sensordaten in die Plattform einspeist
application.name	string	Der Name dieser Anwendung. Dies ist für REST-Clients erforderlich, die Eindeutigkeit dieses Namens wird jedoch nicht erzwungen. Sie wird anderen Entwicklern zur Verfügung gestellt, die ermitteln möchten, welche REST-Anwendung eine Anwendung oder Datenquelle erstellt hat.
dataType	nested object	Der Datentyp definiert das Schema für einen Datenstrom, der von der Fitness API erfasst, in sie eingefügt oder von ihr 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 sind: "blob" "floatList" "floatPoint" "integer" "integerList" "map" "string"
dataType.field[].name	string	Definiert den Namen und das Format von Daten. Im Gegensatz zu Datentypnamen haben Feldnamen keinen Namespace 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 halten kann
device.manufacturer	string	Hersteller des Produkts/der Hardware.
device.model	string	Für den Endnutzer sichtbarer Modellname des Geräts.
device.type	string	Eine Konstante, die den Gerätetyp darstellt. Zulässige Werte sind: "chestStrap" "headMounted" "phone" "scale" "smartDisplay" "tablet" "unknown" "watch"
device.uid	string	Die Seriennummer oder eine andere eindeutige ID der 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 in normaler Form. Die Verschleierung bewahrt die Gleichheit auf, d. h. bei zwei IDs, wenn id1 == id2, verschleiert(id1) == verschleiert(id2).
device.version	string	Versions-String für die Hardware/Software des Geräts.
type	string	Konstante, die den Typ dieser Datenquelle beschreibt. Gibt an, ob diese Datenquelle Roh- oder abgeleitete Daten liefert. Zulässige Werte sind: "derived" "raw"

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource vom Typ „Users.dataSources“ im Antworttext zurückgegeben.

Jetzt testen

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.