Users.dataSources: create

Erstellt eine neue Datenquelle, die für alle zugehörigen Datenquellen eindeutig ist für diesen Nutzer.

Eine Datenquelle ist eine einzigartige Quelle von Sensordaten. Über Datenquellen Rohdaten, die von Hardwaresensoren auf lokalen oder Companion-Geräten stammen. Sie kann auch abgeleitete Daten verfügbar machen, die durch Transformieren oder Zusammenführen anderer Daten erstellt wurden Quellen. Für denselben Datentyp können mehrere Datenquellen vorhanden sein. Alle Daten in jedem Dataset, das in die Fitness API eingefügt oder daraus gelesen wird, hat ein zugehöriger Datenquelle aus.

Jede Datenquelle erzeugt einen eindeutigen Stream von Dataset-Aktualisierungen, wobei eindeutige Kennung der Datenquelle. Nicht alle Änderungen an der Datenquelle wirken sich auf Datenstream-ID, sodass die Daten, die von aktualisierten Versionen derselben Anwendung/Gerät kann dennoch als zu denselben Daten gehörend betrachtet werden Quelle.

Datenquellen werden anhand eines vom Server generierten Strings identifiziert. auf den Inhalt der erstellten Quelle. Das dataStreamId darf beim Aufrufen dieser Methode nicht festgelegt werden. Es werden automatisch vom Server im richtigen Format generiert. Wenn dataStreamId festgelegt ist, muss sie dem Format entsprechen, die der Server generiert. Dieses Format ist eine Kombination aus einigen Feldern aus dem Datenquelle und hat eine bestimmte Reihenfolge. Stimmen sie nicht überein, mit einer Fehlermeldung fehl.

Angeben eines Datentyps, der kein bekannter Typ ist (beginnend mit "com.google.") erstellt eine Datenquelle mit einem benutzerdefinierten Datentyp. Benutzerdefinierte Datentypen können nur von der Anwendung gelesen werden, in der sie erstellt wurden. Benutzerdefinierte Datentypen wurden eingestellt. Standarddatentypen verwenden .

Zusätzlich zu den Datenquellenfeldern, die in der Datenquellen-ID enthalten sind, enthält das Feld Nummer des Entwicklerprojekts, die beim Erstellen der Daten authentifiziert wird Quelle enthalten ist. Diese Entwicklerprojektnummer wird beim Lesen verschleiert 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 angegebene Person. me für Folgendes verwenden: den authentifizierten Nutzer an. 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 Ressource vom Typ „Users.dataSources“ mit den folgenden Attributen an:

Property-Name Wert Beschreibung Hinweise
Erforderliche Attribute
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 ist für andere Entwickler gedacht, die wissen möchten, mit welcher REST eine Anwendung oder Datenquelle erstellt wurde.
dataType nested object Der Datentyp definiert das Schema für einen Datenstrom, der von der Fitness API erfasst, in diese 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: <ph type="x-smartling-placeholder">
    </ph>
  • „blob“
  • „floatList“
  • „floatPoint“
  • „integer“
  • „integerList“
  • „map“
  • „string“
dataType.field[].name string Definiert den Namen und das Format von Daten. Im Gegensatz zu Datentypnamen werden 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 Namespace „com.google“ werden im Rahmen der Plattform gemeinsam genutzt.
device nested object Darstellung eines integrierten Geräts (z. B. eines Smartphones oder Wearables), das Sensoren halten kann
device.manufacturer string Hersteller des Produkts bzw. der Hardware
device.model string Für Endnutzer sichtbarer Modellname des Geräts.
device.type string Eine Konstante, die den Gerätetyp darstellt.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • „chestStrap“
  • „headMounted“
  • „phone“
  • „scale“
  • „smartDisplay“
  • „tablet“
  • „unknown“
  • „watch“
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 kann das UID-Feld klar und normal sehen.

Die Verschleierung wahrt die Gleichheit. bei zwei IDs, wenn 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 Rohdaten oder abgeleitete Daten produziert.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • „derived“
  • „raw“

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource vom Typ „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.