Datenquellen verwalten

Mit der Fitness REST API können Sie Datenquellen erstellen, abrufen und aktualisieren. Eine Datenquelle steht für eine einzigartige Quelle für Sensordaten ist. Sie verwenden Datenquellen, um Fitnessdaten in die Fitnessdaten einzubinden. und Sie können von einer bestimmte Datenquelle eingefügte Fitnessdaten abrufen.

Datenquellen werden durch Users.dataSources repräsentiert .

Datenquelle erstellen

In diesem Beispiel wird gezeigt, wie Sie eine neue Datenquelle mit dem Namen „MyDataSource“ erstellen. mit der Schrittzahl-Inkremente angegeben werden.

HTTP-Methode
POSTEN
Anfrage-URL
https://www.googleapis.com/fitness/v1/users/me/dataSources
Anfragetext
{
  "dataStreamName": "MyDataSource",
  "type": "derived",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "Foo Example App",
    "version": "1"
  },
  "dataType": {
    "field": [
      {
        "name": "steps",
        "format": "integer"
      }
    ],
    "name": "com.google.step_count.delta"
  },
  "device": {
    "manufacturer": "Example Manufacturer",
    "model": "ExampleTablet",
    "type": "tablet",
    "uid": "1000001",
    "version": "1.0"
  }
}
Antwort

Wenn die Datenquelle erstellt wurde, hat die Antwort den Status 200 OK Code. Der Antworttext enthält eine JSON-Darstellung der Datenquelle. einschließlich datasource.dataStreamId die Sie als Datenquellen-ID für nachfolgende Anfragen verwenden können.

Curl-Befehl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \
--header "Content-Type: application/json;encoding=utf-8" -d @createds.json \
"https://www.googleapis.com/fitness/v1/users/me/dataSources"

Bestimmte Datenquelle abrufen

In diesem Beispiel wird gezeigt, wie Sie die Datenquelle („MyDataSource“) abrufen. die Sie im vorherigen Beispiel erstellt haben. Wenn Sie eine neue Datenquelle erstellen, Die dataStreamId enthält eine eindeutige Kennung (in diesen Beispiele). Dies ist die Nummer Ihres Entwicklerprojekts, alle Anfragen, die über dieses Entwicklerkonto gestellt wurden. Verwenden Sie auf jeden Fall die dataStreamId aus der von Ihnen erstellten Datenquelle.

HTTP-Methode
LADEN
Anfrage-URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Anfragetext
Keine
Antwort
Wenn die Datenquelle vorhanden ist, wird der Statuscode 200 OK zurückgegeben. Der Antworttext enthält ein JSON-Darstellung der Datenquelle.
Curl-Befehl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X GET 

--header "Content-Type: application/json;encoding=utf-8" 

"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"

Aggregierte Daten abrufen

In diesem Beispiel wird gezeigt, wie Sie eine bestimmte Datenquelle Daten, in diesem Fall estimated_steps. Dies ist die Datenquelle, die verwendet wird, in der Google Fit App angezeigt wird. Die Zeitstempel in der JSON-Anfrage body sind in Millisekunden.

HTTP-Methode
POSTEN
Anfrage-URL
https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate
Anfragetext
{
  "aggregateBy": [{
    "dataSourceId":
      "derived:com.google.step_count.delta:com.google.android.gms:estimated_steps"
  }],
  "bucketByTime": { "durationMillis": 86400000 },
  "startTimeMillis": 1454284800000,
  "endTimeMillis": 1455062400000
}
Antwort

Wenn die Datenquelle(n) vorhanden sind, wird der Statuscode 200 OK als Antwort zurückgegeben. Die Der Antworttext enthält eine JSON-Darstellung der Datenquelle.

Curl-Befehl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \
--header "Content-Type: application/json;encoding=utf-8" -d @aggregate.json \
"https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate"

Datenquelle aktualisieren

In diesem Beispiel wird gezeigt, wie der Name und die Geräteversion für eine Daten aktualisiert werden. Quelle.

HTTP-Methode
PUT
Anfrage-URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Anfragetext
{
  "dataStreamId": "derived:com.google.step_count.delta:1234567890:Example Manufacturer:ExampleTablet:1000001:MyDataSource",
  "dataStreamName": "MyDataSource",
  "type": "derived",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "Foo Example App",
    "version": "1"
  },
  "dataType": {
    "field": [
      {
        "name": "steps",
        "format": "integer"
      }
    ],
    "name": "com.google.step_count.delta"
  },
  "device": {
    "manufacturer": "Example Manufacturer",
    "model": "ExampleTablet",
    "type": "tablet",
    "uid": "1000001",
    "version": "2.0"
  }
}
Antwort

Wenn die Datenquelle aktualisiert wurde, hat die Antwort den Status 200 OK Code. Der Antworttext enthält eine JSON-Darstellung der Datenquelle.

Curl-Befehl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X PUT \
--header "Content-Type: application/json;encoding=utf-8" -d @updateds.json \
"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"

Datenquellen löschen

In diesem Beispiel wird gezeigt, wie Sie eine Datenquelle löschen.

HTTP-Methode
LÖSCHEN
Anfrage-URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Anfragetext
Keine
Antwort
Wenn die Datenquelle gelöscht wurde, hat die Antwort den Status „200 OK“ Code. Der Antworttext enthält eine JSON-Darstellung der Datenquelle, die wurde gelöscht.
Curl-Befehl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X DELETE \
--header "Content-Type: application/json;encoding=utf-8" \
"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"