Method: devices.create

在使用者的 Google 相簿帳戶中建立微光裝置。

如果已存在裝置與提供的 requestId，系統會傳回 ALREADY_EXISTS 錯誤。如要避免重複裝置，請採取下列做法：

  • 如果您知道現有裝置的 deviceId，請呼叫 devices.get 擷取該裝置。
  • 如果您不知道 deviceId，請使用 requestId 呼叫 devices.delete，移除孤立的裝置，然後再重試這個方法。

每位應用程式使用者最多可建立 100 部裝置。如果超過此上限，系統會傳回 RESOURCE_EXHAUSTED 錯誤。

HTTP 要求

POST https://photosambient.googleapis.com/v1/devices

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

查詢參數

參數
requestId

string

(非必要) 用戶端提供的這項要求專屬 ID。這可用於在網路發生故障時，減少資源重複。

這個 ID 必須採用 UUID (第 4 版) 字串格式，並符合下列規定：

  • 不得包含任何使用者的敏感識別資訊。
  • 必須包含 32 個十六進位字元，以連字號分為五組，格式為「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx」(或 8-4-4-4-12)。

要求主體

要求主體包含 AmbientDevice 的例項。

回應主體

如果成功，回應主體會包含新建立的 AmbientDevice 例項。

授權範圍

需要下列 OAuth 範圍：

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