Gestion des sources de données

L'API REST Fitness vous permet de créer, d'obtenir et de mettre à jour des sources de données. Une source de données représente comme une source unique de données de capteurs. Vous utilisez des sources de données pour insérer des données d'entraînement et récupérer des données de fitness insérées par une source de données particulière.

Les sources de données sont représentées par l'icône Users.dataSources ressource.

Créer une source de données

Cet exemple montre comment créer une source de données nommée "MyDataSource" qui fournit des incréments de nombre de pas.

Méthode HTTP
PUBLIER
Request URL
https://www.googleapis.com/fitness/v1/users/me/dataSources
Corps de la requête
{
  "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"
  }
}
Réponse

Si la source de données a bien été créée, la réponse est un état 200 OK. du code source. Le corps de la réponse contient une représentation JSON de la source de données. y compris un datasource.dataStreamId que vous pouvez utiliser comme ID de source de données pour les requêtes ultérieures.

Commande 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"

Obtenir une source de données particulière

Cet exemple montre comment récupérer la source de données ("MyDataSource") créé dans l'exemple précédent. Lorsque vous créez une source de données, le dataStreamId inclut un identifiant unique (indiqué sous la forme "1234567890" dans ces exemples). Il s'agit du numéro de votre projet de développeur, qui sera identique pour toutes les requêtes effectuées à l'aide de ce compte de développeur. Veillez à utiliser le dataStreamId à partir de la source de données que vous avez créée.

Méthode HTTP
OBTENIR
Request URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Corps de la requête
Aucune
Réponse
Si la source de données existe, la réponse est un code d'état 200 OK. Le corps de la réponse contient un Représentation JSON de la source de données.
Commande 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"

Obtenir des données globales

Cet exemple montre comment interroger une source de données spécifique pour des données agrégées des données (dans ce cas, estimated_steps). Il s'agit de la source de données utilisée pour afficher le nombre de pas dans l'application Google Fit. Notez que les codes temporels dans la requête JSON en millisecondes.

Méthode HTTP
PUBLIER
Request URL
https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate
Corps de la requête
{
  "aggregateBy": [{
    "dataSourceId":
      "derived:com.google.step_count.delta:com.google.android.gms:estimated_steps"
  }],
  "bucketByTime": { "durationMillis": 86400000 },
  "startTimeMillis": 1454284800000,
  "endTimeMillis": 1455062400000
}
Réponse

Si les sources de données existent, la réponse est un code d'état 200 OK. La Le corps de la réponse contient une représentation JSON de la source de données.

Commande 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"

Mettre à jour une source de données

Cet exemple montre comment mettre à jour le nom et la version de l'appareil pour une donnée source.

Méthode HTTP
PUT
Request URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Corps de la requête
{
  "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"
  }
}
Réponse

Si la source de données a bien été mise à jour, la réponse est un état 200 OK. du code source. Le corps de la réponse contient une représentation JSON de la source de données.

Commande 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"

Supprimer une source de données

Cet exemple montre comment supprimer une source de données.

Méthode HTTP
SUPPRIMER
Request URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
Corps de la requête
Aucune
Réponse
Si la source de données a bien été supprimée, la réponse est à l'état 200 OK. du code source. Le corps de la réponse contient une représentation JSON de la source de données qui a été supprimé.
Commande 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"