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

詳情請參閱驗證與授權頁面。

要求主體

在要求主體中，根據修補語意規則，提供 Users.dataSources.dataset resources 的相關部分，並提供下列屬性：

資源名稱 值 說明 附註
必要屬性
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. dataset resources。

試試看！

使用 APIs Explorer 針對即時資料呼叫這個方法，並查看回應。