在資料集中新增資料點。先前不一定要建立資料集。
系統將傳回指定資料集內的所有點,同時發出子呼叫來擷取這個資料集。資料點可以屬於多個資料集。
這個方法不使用修補語意:系統只會插入提供的資料點,不會取代現有資料。立即試用。
要求
HTTP 要求
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
參數
參數名稱 | 值 | 說明 |
---|---|---|
路徑參數 | ||
dataSourceId |
string |
建立資料集的資料來源的資料串流 ID。 |
datasetId |
string |
這個欄位未使用,因此可以安全省略。 |
userId |
string |
為已識別的使用者修補資料集。使用 me 來表示已驗證的使用者。目前僅支援 me 。 |
授權
這項要求至少需要取得下列其中一個範圍的授權:
內容範圍 |
---|
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
詳情請參閱「驗證和授權」網頁。
要求主體
在要求內文中,請根據修補語義的規則,提供具有以下屬性的 Users.dataSources.datasets 資源相關部分:
資源名稱 | 值 | 說明 | 附註 |
---|---|---|---|
必要屬性 | |||
dataSourceId |
string |
在此資料集中建立點的資料來源的資料串流 ID。 | |
maxEndTimeNs |
long |
在這個類別中,所有資料點的最長結束時間,可能是資料集的一部分。時間以 Epoch 紀元時間起算的奈秒為單位。也應與資料集 ID 的第二部分相符。 | |
minStartTimeNs |
long |
在這個物件中,所有資料點的最小開始時間可能代表資料集的部分內容。時間以 Epoch 紀元時間起算的奈秒為單位。也應與資料集 ID 的第一部分相符。 | |
point[] |
list |
資料集中包含的部分資料點清單,依 endTimeNanos 排序。當您擷取小型資料集時,如果只修補資料集或擷取的資料集過大,無法納入單一回應,這份清單將視為完整。 | |
point[].dataTypeName |
string |
定義這個資料點中值格式的資料類型。 | |
point[].endTimeNanos |
long |
這個資料點代表的間隔結束時間,以 Epoch 紀元時間起算的奈秒為單位。 | |
point[].startTimeNanos |
long |
這個資料點代表的間隔開始時間,以 Epoch 紀元時間起算的奈秒為單位。 | |
point[].value[] |
list |
資料點中每個資料類型欄位的值。每個與資料類型欄位對應的值,系統都會按照該欄位在資料來源指定的資料類型中的排列順序出現。 視資料來源類型欄位中的格式列舉值而定,系統只會填入一個整數和浮點欄位。 |
回覆
如果成功的話,這個方法會在回應主體中傳回 Users.dataSources.datasets 資源。
試試看!
使用下方的 APIs Explorer,針對有效資料呼叫這個方法,然後查看回應。