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.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，針對有效資料呼叫這個方法，然後查看回應。