Users.dataSources: update

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. Jetzt ausprobieren

Anfrage

HTTP-Anfrage

PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId

Parameter

Parametername Wert Beschreibung
Pfadparameter
dataSourceId string Die Datenstream-ID der Datenquelle, die aktualisiert werden soll.
userId string Aktualisieren Sie die Datenquelle der identifizierten 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.
dataStreamId string Eine eindeutige Kennung für den Datenstream, der von dieser Datenquelle erzeugt wird. Die Kennung umfasst:

  • Hersteller, Modell und Seriennummer (UID) des physischen Geräts.
  • Der Paketname oder Name der Anwendung. Der Paketname wird verwendet, wenn die Datenquelle von einer Android-App erstellt wurde. Die Entwicklerprojektnummer wird verwendet, wenn die Datenquelle von einem REST-Client erstellt wurde.
  • Der Typ der Datenquelle.
  • Streamname der Datenquelle.
Nicht alle Attribute der Datenquelle werden für die Stream-ID verwendet. Es wird insbesondere nicht die Version der Hardware bzw. Anwendung verwendet. So können wir denselben Stream über Versionsupdates beibehalten. Dies bedeutet auch, dass zwei DataSource-Objekte denselben Datenstream darstellen können, auch wenn sie nicht gleich sind.

Die von einer Android-App erstellte Datenstream-ID hat folgendes Format: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

Das genaue Format der von einem REST-Client erstellten Datenstream-ID lautet: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Wenn eines der optionalen Felder der Datenstream-ID fehlt, wird es in der Datenstream-ID weggelassen. Die minimale Vital-Datenstream-ID wäre: type:dataType.name:developer project number

Die Nummer des Entwicklerprojekts und die Geräte-UID werden verschleiert, wenn sie von einem REST- oder Android-Client gelesen werden, der die Datenquelle nicht erstellt hat. Nur der Ersteller der Datenquelle sieht die Entwicklerprojektnummer klar und normal. Das bedeutet, dass ein Client einen anderen Satz von „data_stream_ids“ sieht als ein anderer Client mit anderen Anmeldedaten.

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.