Utiliser des ensembles de données
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API REST Fitness vous permet de créer, d'obtenir et d'ajouter des points à des ensembles de données. A
un ensemble de données, qui représente un ensemble de points de données provenant d'une source de données particulière.
Les ensembles de données sont représentés par le
Users.dataSources.datasets
ressource.
Ajouter des points à un ensemble de données
Cet exemple montre comment ajouter 10 nouveaux points delta du nombre de pas à une
précédemment vide. Cet exemple suppose que vous avez créé une source de données
comme décrit dans la section Gérer les sources de données.
- Méthode HTTP
- RÉCOMPENSE
- Request URL
https://www.googleapis.com/fitness/v1/users/me/dataSources/
derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001
/datasets/1397513334728708316-1397515179728708316- Corps de la requête
{
"dataSourceId":
"derived:com.google.step_count.delta:1234567890:Example Manufacturer:ExampleTablet:1000001",
"maxEndTimeNs": 1397515179728708316,
"minStartTimeNs": 1397513334728708316,
"point": [
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397513365565713993,
"originDataSourceId": "",
"startTimeNanos": 1397513334728708316,
"value": [
{
"intVal": 8
}
]
},
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397513675197854515,
"originDataSourceId": "",
"startTimeNanos": 1397513530098955298,
"value": [
{
"intVal": 3
}
]
},
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397513764101240710,
"originDataSourceId": "",
"startTimeNanos": 1397513817073528237,
"value": [
{
"intVal": 6
}
]
},
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397513938674093579,
"originDataSourceId": "",
"startTimeNanos": 1397514015761859752,
"value": [
{
"intVal": 5
}
]
},
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397514106400006675,
"originDataSourceId": "",
"startTimeNanos": 1397514181893785805,
"value": [
{
"intVal": 4
}
]
},
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397514304850163634,
"originDataSourceId": "",
"startTimeNanos": 1397514356883524220,
"value": [
{
"intVal": 16
}
]
},
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397514518794639297,
"originDataSourceId": "",
"startTimeNanos": 1397514526864527756,
"value": [
{
"intVal": 13
}
]
},
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397514741275742506,
"originDataSourceId": "",
"startTimeNanos": 1397514626480314270,
"value": [
{
"intVal": 18
}
]
},
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397514813435152213,
"originDataSourceId": "",
"startTimeNanos": 1397514839292833196,
"value": [
{
"intVal": 17
}
]
},
{
"dataTypeName": "com.google.step_count.delta",
"endTimeNanos": 1397515179728708316,
"originDataSourceId": "",
"startTimeNanos": 1397515170565969137,
"value": [
{
"intVal": 11
}
]
}
]
}
- Réponse
La réponse est un code d'état 200 OK. Le corps de la réponse contient un tableau
avec des représentations JSON de tous les points qui ont bien été insérés.
- Commande Curl
$ curl --header "Authorization: Bearer ya29.1.yourtokenvalue" -X PATCH \
--header "Content-Type: application/json;encoding=utf-8" -d @addpoints.json \
"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001/datasets/1397513334728708316-1397515179728708316"
Obtenir un ensemble de données
Cet exemple montre comment récupérer le contenu d'un ensemble de données.
- 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
/datasets/1397513334728708316-1397515179728708316- Corps de la requête
- Aucun.
- Réponse
- Si l'ensemble de données existe, la réponse est un code d'état
200 OK. La réponse
contient une représentation JSON de l'ensemble de données.
- Commande Curl
$ curl --header "Authorization: Bearer ya29.1.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/datasets/1397513334728708316-1397515179728708316"
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThe Fitness REST API allows for the creation, retrieval, and updating of datasets, which represent data points from specific sources.\u003c/p\u003e\n"],["\u003cp\u003eDatasets are identified and managed using the \u003ccode\u003eUsers.dataSources.datasets\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eYou can add data points to a dataset using a PATCH request to the corresponding dataset URL.\u003c/p\u003e\n"],["\u003cp\u003eRetrieving an existing dataset is done with a GET request to the dataset URL.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the "Responsible use of Google Fit" documentation for best practices on handling user data.\u003c/p\u003e\n"]]],[],null,["# Working with Datasets\n\nThe Fitness REST API lets you create, obtain, and add points to datasets. A\ndataset represents a set of data points from a particular data source.\n\nDatasets are represented by the\n[`Users.dataSources.datasets`](/fit/rest/v1/reference/users/dataSources/datasets)\nresource.\n| **Important:** For best practices when managing user data, see [Responsible use of Google Fit](/fit/overview#responsible_use_of_google_fit).\n\nAdd points to a dataset\n-----------------------\n\nThis example demonstrates how to add ten new step count delta points to a\npreviously empty dataset. This example assumes that you created a data source\nas described in [Managing Data Sources](/fit/rest/v1/data-sources).\n\nHTTP method\n: PATCH\n\nRequest URL\n: `https://www.googleapis.com/fitness/v1/users/me/dataSources/` \n **derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001\n /datasets/1397513334728708316-1397515179728708316**\n\nRequest body\n:\n\n {\n \"dataSourceId\":\n \"derived:com.google.step_count.delta:1234567890:Example Manufacturer:ExampleTablet:1000001\",\n \"maxEndTimeNs\": 1397515179728708316,\n \"minStartTimeNs\": 1397513334728708316,\n \"point\": [\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397513365565713993,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397513334728708316,\n \"value\": [\n {\n \"intVal\": 8\n }\n ]\n },\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397513675197854515,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397513530098955298,\n \"value\": [\n {\n \"intVal\": 3\n }\n ]\n },\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397513764101240710,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397513817073528237,\n \"value\": [\n {\n \"intVal\": 6\n }\n ]\n },\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397513938674093579,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397514015761859752,\n \"value\": [\n {\n \"intVal\": 5\n }\n ]\n },\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397514106400006675,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397514181893785805,\n \"value\": [\n {\n \"intVal\": 4\n }\n ]\n },\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397514304850163634,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397514356883524220,\n \"value\": [\n {\n \"intVal\": 16\n }\n ]\n },\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397514518794639297,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397514526864527756,\n \"value\": [\n {\n \"intVal\": 13\n }\n ]\n },\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397514741275742506,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397514626480314270,\n \"value\": [\n {\n \"intVal\": 18\n }\n ]\n },\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397514813435152213,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397514839292833196,\n \"value\": [\n {\n \"intVal\": 17\n }\n ]\n },\n {\n \"dataTypeName\": \"com.google.step_count.delta\",\n \"endTimeNanos\": 1397515179728708316,\n \"originDataSourceId\": \"\",\n \"startTimeNanos\": 1397515170565969137,\n \"value\": [\n {\n \"intVal\": 11\n }\n ]\n }\n ]\n }\n\nResponse\n\n: The response is a `200 OK` status code. The response body contains an array\n with JSON representations of all the points that were inserted successfully.\n\nCurl command\n:\n\n ```\n $ curl --header \"Authorization: Bearer ya29.1.yourtokenvalue\" -X PATCH \\\n --header \"Content-Type: application/json;encoding=utf-8\" -d @addpoints.json \\\n \"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001/datasets/1397513334728708316-1397515179728708316\"\n ```\n\nGet a dataset\n-------------\n\nThis example demonstrates how to get the contents of a dataset.\n\nHTTP method\n: GET\n\nRequest URL\n: `https://www.googleapis.com/fitness/v1/users/me/dataSources/` \n **derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001\n /datasets/1397513334728708316-1397515179728708316**\n\nRequest body\n: None.\n\nResponse\n: If the dataset exists, the response is a `200 OK` status code. The response\n body contains a JSON representation of the dataset.\n\nCurl command\n:\n\n ```\n $ curl --header \"Authorization: Bearer ya29.1.yourtokenvalue\" -X GET \\\n --header \"Content-Type: application/json;encoding=utf-8\" \\\n \"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001/datasets/1397513334728708316-1397515179728708316\"\n ```"]]
