Users.dataSources: update

Aktualisiert die angegebene Datenquelle. Das dataStreamId, dataType, type, dataStreamName und device-Properties mit Ausnahme von version, kann nicht geändert werden.

Datenquellen werden durch ihre 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 Datenquelle, die aktualisiert werden soll.
userId string Aktualisieren 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.
dataStreamId string Eine eindeutige Kennung für den von dieser Datenquelle erstellten Datenstream. 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.
  • Name des Streams der Datenquelle.
Nicht alle Attribute der Datenquelle werden als Teil der Stream-ID verwendet. Insbesondere die Version der Hardware bzw. der Anwendung wird nicht verwendet. So bleibt durch Versionsupdates immer derselbe Stream erhalten. Das bedeutet auch, dass zwei DataSource-Objekte denselben Datenstream darstellen können, selbst wenn sie nicht gleich sind.

Die Datenstream-ID, die von einer Android-App erstellt wird, 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 ist: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Wenn keine der optionalen Felder für die Datenstream-ID vorhanden sind, werden sie in der Datenstream-ID ausgelassen. Die mindestens funktionsfähige Datenstream-ID wäre: type:dataType.name:developer Projektnummer

Schließlich werden die Entwicklerprojektnummer und die Geräte-UID verschleiert, wenn sie von einem REST- oder Android-Client gelesen werden, der die Datenquelle nicht erstellt hat. Nur dem Ersteller der Datenquelle wird die Entwicklerprojektnummer in klarer und normaler Form angezeigt. Das bedeutet, dass einem Client ein anderer Satz von „data_stream_ids“ angezeigt wird als einem anderen Client mit anderen Anmeldedaten.

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.