傳回含有開始和結束時間的所有資料點的資料集 與資料集的最短開始時間重疊, 結束時間上限。具體來說,任何資料點的開始時間較小 等於或等於資料集結束時間,且結束時間大於或等於資料集 等於資料集開始時間。 立即試用。
要求
HTTP 要求
GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
參數
參數名稱 | 值 | 說明 |
---|---|---|
路徑參數 | ||
dataSourceId |
string |
建立資料集的資料來源資料串流 ID。 |
datasetId |
string |
資料集 ID,包括資料點開始時間下限的值 以及資料點上限的結束時間,以 Epoch 紀元時間的奈秒為單位。 ID 格式為「startTime-endTime」 其中 startTime 和 endTime 是 64 位元整數。 |
userId |
string |
針對識別對象擷取資料集。使用 me 即可:
指出已通過驗證的使用者。目前僅支援 me
讓應用程式從可以最快做出回應的位置
回應使用者要求
|
選用的查詢參數 | ||
limit |
integer |
如有指定,則不會將此超過這麼多資料點納入 如果資料集內有多個資料點,NextPageToken 則會在資料集回應中設定 系統會在時間範圍結束時套用限制。也就是說 缺少pageToken,這是最新的 limit資料 點數。 |
pageToken |
string |
接續權杖,可用於分頁大型資料集。
如要取得資料集的下一頁,請將此參數設為
前一則回覆的 nextPageToken 。每次
呼叫會產生部分資料集,其中資料點的結束時間戳記為
遠低於前一個部分回應中的值
|
授權
這項要求需要授權,且至少要有下列其中一個範圍:
範圍 |
---|
https://www.googleapis.com/auth/fitness.activity.read |
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.read |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.read |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.read |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.read |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
詳情請參閱「驗證與授權」網頁。
要求主體
請勿使用這個方法提供請求主體。
回應
如果成功,這個方法會在回應主體中傳回 Users.dataSources.datasets 資源。
試試看!
使用下方的 APIs Explorer,針對即時資料呼叫這個方法,看看會有什麼結果。