Administra fuentes de datos

La API de REST de Fitness te permite crear, obtener y actualizar fuentes de datos. Una fuente de datos representa una fuente única de datos de sensores. Usas fuentes de datos para insertar datos de actividad física en la cuenta. almacenar y puedes recuperar datos de actividad física insertados por una fuente de datos en particular.

Las fuentes de datos se representan con Users.dataSources. recurso.

Cómo crear una fuente de datos

En este ejemplo, se muestra cómo crear una nueva fuente de datos llamada "MyDataSource" que proporciona incrementos en el recuento de pasos.

Método HTTP
PUBLICAR
Solicitar URL
https://www.googleapis.com/fitness/v1/users/me/dataSources
Cuerpo de la solicitud
{
  "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"
  }
}
Respuesta

Si la fuente de datos se creó correctamente, la respuesta tendrá un estado 200 OK. código. El cuerpo de la respuesta contiene una representación JSON de la fuente de datos. incluido un datasource.dataStreamId que puedes usar como el ID de la fuente de datos en solicitudes posteriores.

Comando de Curl
$ 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"

Obtén una fuente de datos específica

Este ejemplo muestra cómo recuperar la fuente de datos (“MyDataSource”) que creaste en el ejemplo anterior. Cuando creas una nueva fuente de datos, el dataStreamId incluye un identificador único (que se muestra como "1234567890" en estas ejemplos). Este es tu número de proyecto de desarrollador, y será el mismo para todas las solicitudes realizadas con esa cuenta de desarrollador en particular. Asegúrate de usar dataStreamId de la fuente de datos que creaste.

Método HTTP
OBTENER
Solicitar URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Cuerpo de la solicitud
Ninguno
Respuesta
Si la fuente de datos existe, la respuesta es un código de estado 200 OK. El cuerpo de la respuesta contiene un Representación JSON de la fuente de datos.
Comando de Curl
$ 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"

Obtén datos agregados

En este ejemplo, se muestra cómo consultar una fuente de datos específica para los datos datos, en este caso estimated_steps, que es la fuente de datos que se usa para mostrar recuento de pasos en la app de Google Fit. Ten en cuenta que las marcas de tiempo en la solicitud JSON están en milisegundos.

Método HTTP
PUBLICAR
Solicitar URL
https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate
Cuerpo de la solicitud
{
  "aggregateBy": [{
    "dataSourceId":
      "derived:com.google.step_count.delta:com.google.android.gms:estimated_steps"
  }],
  "bucketByTime": { "durationMillis": 86400000 },
  "startTimeMillis": 1454284800000,
  "endTimeMillis": 1455062400000
}
Respuesta

Si las fuentes de datos existen, la respuesta es un código de estado 200 OK. El contiene una representación JSON de la fuente de datos.

Comando de Curl
$ 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"

Actualizar una fuente de datos

En este ejemplo, se muestra cómo actualizar el nombre y la versión del dispositivo de un conjunto de datos fuente.

Método HTTP
PUT
Solicitar URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Cuerpo de la solicitud
{
  "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"
  }
}
Respuesta

Si la fuente de datos se actualiza correctamente, la respuesta tendrá un estado 200 OK. código. El cuerpo de la respuesta contiene una representación JSON de la fuente de datos.

Comando de Curl
$ 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"

Cómo borrar una fuente de datos

En este ejemplo, se muestra cómo borrar una fuente de datos.

Método HTTP
BORRAR
Solicitar URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Cuerpo de la solicitud
Ninguno
Respuesta
Si la fuente de datos se borra correctamente, la respuesta tiene un estado 200 OK. código. El cuerpo de la respuesta contiene una representación JSON de la fuente de datos que se borró.
Comando de Curl
$ 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"