Zarządzanie źródłami danych

Interfejs Fitness API typu REST pozwala tworzyć, pobierać i aktualizować źródła danych. Źródło danych reprezentuje unikalne źródło danych z czujnika. Za pomocą źródeł danych możesz wstawiać dane o aktywności fizycznej do sklepu z informacjami o aktywności fizycznej, a także pobierać takie dane z określonego źródła.

Źródła danych są reprezentowane przez zasób Users.dataSources.

Utwórz źródło danych

Ten przykład pokazuje, jak utworzyć nowe źródło danych o nazwie "MyDataSource" z przyrostem liczby kroków.

Metoda HTTP
OPUBLIKUJ
Adres URL żądania
https://www.googleapis.com/fitness/v1/users/me/dataSources
Treść żądania
{
  "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"
  }
}
Odpowiedź

Jeśli źródło danych zostanie utworzone, odpowiedzią będzie kod stanu 200 OK. Treść odpowiedzi zawiera kod JSON reprezentujący źródło danych, w tym właściwość datasource.dataStreamId, której możesz używać jako identyfikatora źródła danych w kolejnych żądaniach.

Polecenie url
$ 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"

Pobieranie konkretnego źródła danych

Ten przykład pokazuje, jak pobrać źródło danych ("MyDataSource") utworzone w poprzednim przykładzie. Gdy tworzysz nowe źródło danych, właściwość dataStreamId zawiera unikalny identyfikator (w tych przykładach widoczny jest jako „"1234567890&quot”). Jest to numer projektu dewelopera. Nie będzie on taki sam w przypadku wszystkich żądań wysyłanych z tego konkretnego konta dewelopera. Pamiętaj, aby użyć właściwości dataStreamId ze utworzonego przez siebie źródła danych.

Metoda HTTP
UZYSKAJ
Adres URL żądania
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Treść żądania
Brak
Odpowiedź
Jeśli źródło danych istnieje, odpowiedź to kod stanu 200 OK. Treść odpowiedzi zawiera źródło danych w formacie JSON.
Polecenie url
$ 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"

Pobieranie danych zbiorczych

Ten przykład pokazuje, jak wykonać zapytanie w przypadku określonego źródła danych w przypadku danych zbiorczych (w tym przypadku estimated_steps), które jest źródłem informacji o liczbie kroków w aplikacji Google Fit. Sygnatury czasowe w treści żądania JSON są wyrażone w milisekundach.

Metoda HTTP
OPUBLIKUJ
Adres URL żądania
https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate
Treść żądania
{
  "aggregateBy": [{
    "dataSourceId":
      "derived:com.google.step_count.delta:com.google.android.gms:estimated_steps"
  }],
  "bucketByTime": { "durationMillis": 86400000 },
  "startTimeMillis": 1454284800000,
  "endTimeMillis": 1455062400000
}
Odpowiedź

Jeśli źródła danych istnieją, odpowiedź to kod stanu 200 OK. Treść odpowiedzi zawiera źródło danych w formacie JSON.

Polecenie url
$ 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"

Aktualizowanie źródła danych

Ten przykład pokazuje, jak zaktualizować nazwę i wersję urządzenia źródła danych.

Metoda HTTP
PUT
Adres URL żądania
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Treść żądania
{
  "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"
  }
}
Odpowiedź

Jeśli źródło danych zostanie zaktualizowane, odpowiedzią będzie kod stanu 200 OK. Treść odpowiedzi zawiera źródło danych w formacie JSON.

Polecenie url
$ 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"

Usuwanie źródła danych

Ten przykład pokazuje, jak usunąć źródło danych.

Metoda HTTP
USUŃ
Adres URL żądania
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Treść żądania
Brak
Odpowiedź
Jeśli źródło danych zostanie usunięte, odpowiedzią będzie kod stanu 200 OK. Treść odpowiedzi zawiera usunięte źródło danych w formacie JSON.
Polecenie url
$ 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"