Users.dataSources: update

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. 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 zu aktualisierenden Datenquelle.
userId string Aktualisieren 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.
dataStreamId string Eine eindeutige Kennung für den Datenstream, der von dieser Datenquelle erzeugt wird. Die ID enthält:

  • Hersteller, Modell und Seriennummer (UID) des physischen Geräts.
  • 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.
  • Der Streamname der Datenquelle.
. Nicht alle Attribute der Datenquelle werden als Teil der Stream-ID verwendet. Insbesondere wird die Version der Hardware/Anwendung nicht genutzt. So können wir denselben Stream über Versionsupdates beibehalten. Das bedeutet auch, dass zwei DataSource-Objekte denselben Datenstream darstellen, obwohl sie nicht gleich sind.

Das Format der von einer Android-App erstellten Datenstream-ID ist: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

Das genaue Format der Datenstream-ID, die von einem REST-Client erstellt wird, ist: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Wenn eines der optionalen Felder für die Datenstream-ID nicht vorhanden ist, wird es in der Datenstream-ID weggelassen. Die minimale realisierbare Datenstream-ID wäre: type:dataType.name:developer project number

Schließlich werden die Entwicklerprojektnummer und die Geräte-ID 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 für einen Client andere data_stream_ids angezeigt werden als für einen anderen Client mit anderen Anmeldedaten.

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:
  • „blob“
  • „floatList“
  • „floatPoint“
  • „integer“
  • „integerList“
  • „map“
  • „string“
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:
  • „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 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:
  • „derived“
  • „raw“

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.