Method: devices.patch

更新指定裝置的相關資訊。

如果裝置不存在或不屬於使用者,系統會傳回 NOT_FOUND 錯誤。

HTTP 要求

PATCH https://photosambient.googleapis.com/v1/devices/{deviceId}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
deviceId

string

必要欄位。裝置的專屬 ID。

查詢參數

參數
updateMask

string (FieldMask format)

選用設定。要更新的 AmbientDevice 欄位清單。

舉例來說,如要更新裝置的 displayName,請務必在要求的 updateMask 中提供欄位路徑 userSettings.displayName

特殊值 * 可用來表示應更新所有可更新的欄位。

如果省略,系統會改用隱含的欄位遮罩,等同於 device 中填入的所有欄位 (即具有非空值)。

這是以半形逗號分隔的完整欄位名稱清單。範例:"user.displayName,photo"

要求主體

要求主體包含 AmbientDevice 的例項。

回應主體

如果成功,回應主體會包含 AmbientDevice 的執行例項。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/photosambient.mediaitems