使用資料集

您可以使用 Fitness REST API 建立、取得及新增資料集點數。A 罩杯 資料集代表來自特定資料來源的一組資料點。

資料集會以 Users.dataSources.datasets 資源表示。

新增資料點至資料集

以下範例說明如何將十個新的步數差異點 先前為空的資料集本範例假設您已按照「管理資料來源」一文所述建立資料來源。

HTTP 方法
PATCH
要求網址
https://www.googleapis.com/fitness/v1/users/me/dataSources/
derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001
/datasets/1397513334728708316-1397515179728708316
要求主體
{
 
"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
       
}
     
]
   
}
 
]
}

回應

回應是 200 OK 狀態碼。回應主體包含陣列 。

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"

取得資料集

本範例說明如何取得資料集的內容。

HTTP 方法
GET
要求網址
https://www.googleapis.com/fitness/v1/users/me/dataSources/
derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001
/datasets/1397513334728708316-1397515179728708316
要求主體
無。
回應
如果資料集存在,回應會是 200 OK 狀態碼。回應 主體含有資料集的 JSON 表示法。
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"