Users.dataSources.dataPointChanges: list

Abfragen nach den Datenpunkten des Nutzers für eine bestimmte Datenquelle. Jetzt testen.

Anfrage

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Pfadparameter
dataSourceId string Die Datenstream-ID der Datenquelle, die das Dataset erstellt hat.
userId string Datenpunkte für die identifizierte Person auflisten. Verwenden Sie me, um den authentifizierten Nutzer anzugeben. Derzeit wird nur me unterstützt.
Optionale Suchparameter
limit integer Wenn angegeben, werden maximal so viele Datenpunktänderungen in die Antwort aufgenommen.
pageToken string Das Fortsetzungstoken wird zum Durchsuchen großer Ergebnissätze verwendet. Um auf die nächste Seite mit Ergebnissen zu gelangen, legen Sie diesen Parameter auf den Wert nextPageToken aus der vorherigen Antwort fest.

Autorisierung

Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

Umfang
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "insertedDataPoint": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "deletedDataPoint": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "nextPageToken": string,
  "dataSourceId": string
}
Name der Eigenschaft Wert Beschreibung Hinweise
insertedDataPoint[] list Datenpunkte für den Nutzer wurden eingefügt.
insertedDataPoint[].startTimeNanos long Die Startzeit des Intervalls, das durch diesen Datenpunkt dargestellt wird, in Nanosekunden seit der Epoche.
insertedDataPoint[].endTimeNanos long Die Endzeit des Intervalls, das durch diesen Datenpunkt dargestellt wird, in Nanosekunden seit der Epoche.
insertedDataPoint[].dataTypeName string Der Datentyp, der das Format der Werte in diesem Datenpunkt definiert.
insertedDataPoint[].originDataSourceId string Wenn der Datenpunkt in einem Dataset für eine abgeleitete Datenquelle enthalten ist, wird dieses Feld mit der ID des Datenquellenstreams gefüllt, der den Datenpunkt ursprünglich erstellt hat.

ACHTUNG: Verwenden Sie dieses Feld nur für die Fehlerbehebung. Der Wert dieses Feldes, sofern es dafür festgelegt ist, ist ein Implementierungsdetail und garantiert nicht, dass er konsistent bleibt.
insertedDataPoint[].value[] list Werte der einzelnen Datentypfelder für den Datenpunkt. Es wird erwartet, dass jeder Wert, der einem Datentypfeld entspricht, in derselben Reihenfolge auftritt, in der das Feld im Datentyp einer Datenquelle aufgeführt ist.

Es wird nur eines der Felder „Ganzzahl“ und „Gleitkommazahl“ ausgefüllt, je nach Aufzählungsformat im Typfeld der Datenquelle.

insertedDataPoint[].value[].intVal integer Ganzzahlwert. Ist dies festgelegt, dürfen keine anderen Werte festgelegt werden.
insertedDataPoint[].value[].fpVal double Gleitkommawert. Ist dies festgelegt, dürfen keine anderen Werte festgelegt werden.
insertedDataPoint[].value[].stringVal string Stringwert. Ist dies festgelegt, dürfen keine anderen Werte festgelegt werden. Strings sollten nach Möglichkeit klein gehalten werden. Für Datenstreams mit großen Stringwerten und hoher Datenhäufigkeit kann es zu Stichprobefehlern kommen.
insertedDataPoint[].value[].mapVal[] list Kartenwert. Der gültige Schlüsselbereich und die gültigen Einheiten für den entsprechenden Wert jedes Eintrags sollten als Teil der Datentypdefinition dokumentiert werden. Schlüssel sollten nach Möglichkeit klein gehalten werden. Für Datenstreams mit großen Schlüsseln und hoher Datenhäufigkeit können Daten reduziert werden.
insertedDataPoint[].value[].mapVal[].key string
insertedDataPoint[].value[].mapVal[].value nested object
insertedDataPoint[].value[].mapVal[].value.fpVal double Gleitkommawert.
insertedDataPoint[].modifiedTimeMillis long Gibt an, wann dieser Datenpunkt zuletzt geändert wurde. Dies ist nur in Kontexten nützlich, in denen wir die Datenänderungen auflisten, anstatt den aktuellen Status der Daten darzustellen.
insertedDataPoint[].rawTimestampNanos long Der unbearbeitete Zeitstempel aus dem ursprünglichen SensorEvent.
insertedDataPoint[].computationTimeMillis long DIESES FELD NICHT VERWENDEN. Sie wird ignoriert und nicht gespeichert.
deletedDataPoint[] list Die Datenpunkte des Nutzers wurden gelöscht. Hinweis: Änderungen sollten vor der Verarbeitung von Einfügungen geparst werden.
deletedDataPoint[].startTimeNanos long Die Startzeit des Intervalls, das durch diesen Datenpunkt dargestellt wird, in Nanosekunden seit der Epoche.
deletedDataPoint[].endTimeNanos long Die Endzeit des Intervalls, das durch diesen Datenpunkt dargestellt wird, in Nanosekunden seit der Epoche.
deletedDataPoint[].dataTypeName string Der Datentyp, der das Format der Werte in diesem Datenpunkt definiert.
deletedDataPoint[].originDataSourceId string Wenn der Datenpunkt in einem Dataset für eine abgeleitete Datenquelle enthalten ist, wird dieses Feld mit der ID des Datenquellenstreams gefüllt, der den Datenpunkt ursprünglich erstellt hat.

ACHTUNG: Verwenden Sie dieses Feld nur für die Fehlerbehebung. Der Wert dieses Feldes, sofern es dafür festgelegt ist, ist ein Implementierungsdetail und garantiert nicht, dass er konsistent bleibt.
deletedDataPoint[].value[] list Werte der einzelnen Datentypfelder für den Datenpunkt. Es wird erwartet, dass jeder Wert, der einem Datentypfeld entspricht, in derselben Reihenfolge auftritt, in der das Feld im Datentyp einer Datenquelle aufgeführt ist.

Es wird nur eines der Felder „Ganzzahl“ und „Gleitkommazahl“ ausgefüllt, je nach Aufzählungsformat im Typfeld der Datenquelle.

deletedDataPoint[].value[].intVal integer Ganzzahlwert. Ist dies festgelegt, dürfen keine anderen Werte festgelegt werden.
deletedDataPoint[].value[].fpVal double Gleitkommawert. Ist dies festgelegt, dürfen keine anderen Werte festgelegt werden.
deletedDataPoint[].value[].stringVal string Stringwert. Ist dies festgelegt, dürfen keine anderen Werte festgelegt werden. Strings sollten nach Möglichkeit klein gehalten werden. Für Datenstreams mit großen Stringwerten und hoher Datenhäufigkeit kann es zu Stichprobefehlern kommen.
deletedDataPoint[].value[].mapVal[] list Kartenwert. Der gültige Schlüsselbereich und die gültigen Einheiten für den entsprechenden Wert jedes Eintrags sollten als Teil der Datentypdefinition dokumentiert werden. Schlüssel sollten nach Möglichkeit klein gehalten werden. Für Datenstreams mit großen Schlüsseln und hoher Datenhäufigkeit können Daten reduziert werden.
deletedDataPoint[].value[].mapVal[].key string
deletedDataPoint[].value[].mapVal[].value nested object
deletedDataPoint[].value[].mapVal[].value.fpVal double Gleitkommawert.
deletedDataPoint[].modifiedTimeMillis long Gibt an, wann dieser Datenpunkt zuletzt geändert wurde. Dies ist nur in Kontexten nützlich, in denen wir die Datenänderungen auflisten, anstatt den aktuellen Status der Daten darzustellen.
deletedDataPoint[].rawTimestampNanos long Der unbearbeitete Zeitstempel aus dem ursprünglichen SensorEvent.
deletedDataPoint[].computationTimeMillis long DIESES FELD NICHT VERWENDEN. Sie wird ignoriert und nicht gespeichert.
nextPageToken string Das Fortsetzungstoken wird zum Durchsuchen großer Ergebnissätze verwendet. Geben Sie diesen Wert in einer nachfolgenden Anfrage an, um die nächste Ergebnisseite zurückzugeben.
dataSourceId string Die Datenstream-ID der Datenquelle mit Änderungen an Datenpunkten.

Testen!

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