Users.dataSources.dataPointChanges: list

Abfragen von Datenpunktänderungen 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, in der das Dataset erstellt wurde.
userId string Listen Sie Datenpunkte für die identifizierte Person auf. Mit me geben Sie mit dem authentifizierten Nutzer. Derzeit wird nur me unterstützt.
Optionale Abfrageparameter
limit integer Wenn angegeben, werden nicht mehr als diese Anzahl von Datenpunktänderungen einbezogen in der Antwort angeben.
pageToken string Das Fortsetzungstoken wird zum Durchsuchen großer Ergebnissätze verwendet. Legen Sie für diesen Parameter den Wert nextPageToken aus der vorherigen Antwort.

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 durch diesen Datenpunkt dargestellten Intervalls in Nanosekunden seit der Epoche.
insertedDataPoint[].endTimeNanos long Die Endzeit des durch diesen Datenpunkt dargestellten Intervalls 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 Datenquellenstream-ID gefüllt, mit der der Datenpunkt ursprünglich erstellt wurde.

WARNUNG: Dieses Feld sollte ausschließlich für die Fehlerbehebung verwendet werden. Der Wert dieses Feldes ist, sofern er überhaupt festgelegt ist, ein Implementierungsdetail und seine Konsistenz ist nicht garantiert.
insertedDataPoint[].value[] list Werte jedes Datentypfelds für den Datenpunkt. Es wird davon ausgegangen, dass alle Werte, die einem Datentypfeld entsprechen, in derselben Reihenfolge auftreten, in der das Feld im Datentyp aufgeführt ist, der in einer Datenquelle angegeben ist.

Nur eines der Felder für Ganzzahl oder Gleitkomma wird ausgefüllt, je nachdem, welcher Formatwert im Typfeld der Datenquelle angegeben wurde.

insertedDataPoint[].value[].intVal integer Ganzzahlwert. Wenn dieser Parameter festgelegt ist, dürfen keine anderen Werte festgelegt werden.
insertedDataPoint[].value[].fpVal double Gleitkommawert. Wenn dieser Parameter festgelegt ist, dürfen keine anderen Werte festgelegt werden.
insertedDataPoint[].value[].stringVal string Stringwert. Wenn dieser Parameter festgelegt ist, dürfen keine anderen Werte festgelegt werden. Strings sollten möglichst klein gehalten werden. Bei Datenstreams mit großen Stringwerten und hoher Datenhäufigkeit kann es zu einer Herabstufung der Stichproben kommen.
insertedDataPoint[].value[].mapVal[] list Zuordnungswert. Der gültige Schlüsselbereich und die Einheiten für den entsprechenden Wert jedes Eintrags sollten als Teil der Datentypdefinition dokumentiert werden. Schlüssel sollten möglichst klein gehalten werden. Bei Datenstreams mit großen Schlüsseln und hoher Datenhäufigkeit wird möglicherweise eine geringere Stichprobenerhebung verwendet.
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. Nur nützlich, wenn die Datenänderungen aufgelistet werden und nicht der aktuelle Status der Daten dargestellt wird.
insertedDataPoint[].rawTimestampNanos long Der unformatierte Zeitstempel des ursprünglichen SensorEvent.
insertedDataPoint[].computationTimeMillis long VERWENDEN SIE DIESES FELD NICHT. Sie wird ignoriert und nicht gespeichert.
deletedDataPoint[] list Datenpunkte für den Nutzer wurden gelöscht. Hinweis: Dieser Wert sollte bei Änderungen geparst werden, bevor Einfügungen verarbeitet werden.
deletedDataPoint[].startTimeNanos long Die Startzeit des durch diesen Datenpunkt dargestellten Intervalls in Nanosekunden seit der Epoche.
deletedDataPoint[].endTimeNanos long Die Endzeit des durch diesen Datenpunkt dargestellten Intervalls 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 Datenquellenstream-ID gefüllt, mit der der Datenpunkt ursprünglich erstellt wurde.

WARNUNG: Dieses Feld sollte ausschließlich für die Fehlerbehebung verwendet werden. Der Wert dieses Feldes ist, sofern er überhaupt festgelegt ist, ein Implementierungsdetail und seine Konsistenz ist nicht garantiert.
deletedDataPoint[].value[] list Werte jedes Datentypfelds für den Datenpunkt. Es wird davon ausgegangen, dass alle Werte, die einem Datentypfeld entsprechen, in derselben Reihenfolge auftreten, in der das Feld im Datentyp aufgeführt ist, der in einer Datenquelle angegeben ist.

Nur eines der Felder für Ganzzahl oder Gleitkomma wird ausgefüllt, je nachdem, welcher Formatwert im Typfeld der Datenquelle angegeben wurde.

deletedDataPoint[].value[].intVal integer Ganzzahlwert. Wenn dieser Parameter festgelegt ist, dürfen keine anderen Werte festgelegt werden.
deletedDataPoint[].value[].fpVal double Gleitkommawert. Wenn dieser Parameter festgelegt ist, dürfen keine anderen Werte festgelegt werden.
deletedDataPoint[].value[].stringVal string Stringwert. Wenn dieser Parameter festgelegt ist, dürfen keine anderen Werte festgelegt werden. Strings sollten möglichst klein gehalten werden. Bei Datenstreams mit großen Stringwerten und hoher Datenhäufigkeit kann es zu einer Herabstufung der Stichproben kommen.
deletedDataPoint[].value[].mapVal[] list Zuordnungswert. Der gültige Schlüsselbereich und die Einheiten für den entsprechenden Wert jedes Eintrags sollten als Teil der Datentypdefinition dokumentiert werden. Schlüssel sollten möglichst klein gehalten werden. Bei Datenstreams mit großen Schlüsseln und hoher Datenhäufigkeit wird möglicherweise eine geringere Stichprobenerhebung verwendet.
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. Nur nützlich, wenn die Datenänderungen aufgelistet werden und nicht der aktuelle Status der Daten dargestellt wird.
deletedDataPoint[].rawTimestampNanos long Der unformatierte Zeitstempel des ursprünglichen SensorEvent.
deletedDataPoint[].computationTimeMillis long VERWENDEN SIE DIESES FELD NICHT. 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 der Datenpunkte.

Testen!

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