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.