Làm việc với Tập dữ liệu
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Fitness REST API cho phép bạn tạo, thu và thêm điểm vào tập dữ liệu. Đáp
đại diện cho một tập hợp các điểm dữ liệu từ một nguồn dữ liệu cụ thể.
Tập dữ liệu được biểu thị bằng
Users.dataSources.datasets
nguồn.
Thêm điểm vào tập dữ liệu
Ví dụ này minh hoạ cách thêm 10 điểm delta số bước mới vào
tập dữ liệu trống trước đó. Ví dụ này giả định rằng bạn đã tạo một nguồn dữ liệu
như mô tả trong bài viết Quản lý nguồn dữ liệu.
- Phương thức HTTP
- PHẦN TIÊU CHUẨN
- URL yêu cầu
https://www.googleapis.com/fitness/v1/users/me/dataSources/
derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001
/datasets/1397513334728708316-1397515179728708316- Nội dung yêu cầu
{
"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
}
]
}
]
}
- Phản hồi
Phản hồi là mã trạng thái 200 OK. Nội dung phản hồi chứa một mảng
với bản biểu diễn JSON của tất cả các điểm đã được chèn thành công.
- Lệnh 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"
Lấy tập dữ liệu
Ví dụ này minh hoạ cách lấy nội dung của tập dữ liệu.
- Phương thức HTTP
- TẢI
- URL yêu cầu
https://www.googleapis.com/fitness/v1/users/me/dataSources/
derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001
/datasets/1397513334728708316-1397515179728708316- Nội dung yêu cầu
- Không có.
- Phản hồi
- Nếu tập dữ liệu tồn tại, phản hồi là mã trạng thái
200 OK. Phản hồi
chứa nội dung biểu diễn JSON của tập dữ liệu.
- Lệnh 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"
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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 ```"]]
