Users.dataSources.datasets: patch

將資料點新增至資料集。不一定要事先建立資料集。 指定資料集中的所有點都會與後續的呼叫一併傳回 擷取此資料集。資料點可屬於多個資料集。

這個方法不使用修補語意：提供的資料點 插入文字，且沒有替換現有資料。 立即試用。

要求

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

詳情請參閱「驗證與授權」網頁。

要求主體

在要求主體中，請根據 Patch 語意的規則提供具有以下屬性的 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，針對即時資料呼叫這個方法，看看會有什麼結果。