Method: partners.devices.claim

為客戶認領裝置並新增至零接觸註冊機制。如果裝置已由其他客戶聲明擁有權，該呼叫會傳回錯誤。

HTTP 要求

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim

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

路徑參數

參數
partnerId

string (int64 format)

必要欄位。經銷商合作夥伴的 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "sectionType": enum (DeviceProvisioningSectionType),
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "preProvisioningToken": string,
  // Union field customer can be only one of the following:
  "customerId": string,
  "googleWorkspaceCustomerId": string
  // End of list of possible types for union field customer.
}
欄位
deviceIdentifier

object (DeviceIdentifier)

必要欄位。必要欄位。要聲明擁有權的裝置 ID。
sectionType

enum (DeviceProvisioningSectionType)

必要欄位。裝置佈建記錄的部分類型。
deviceMetadata

object (DeviceMetadata)

選用設定。要附加到裝置的中繼資料。
preProvisioningToken

string

選用設定。只能在 Chrome OS 裝置上設定，且只能設定一次。
聯集欄位 customer。必要欄位。要領取裝置的客戶。customer 只能是下列其中一項：
customerId

string (int64 format)

要領取裝置的客戶 ID。
googleWorkspaceCustomerId

string

Google Workspace 客戶 ID。

回應主體

如果成功，回應主體會含有以下結構的資料：

包含版權聲明裝置 ID 的回應訊息。

JSON 表示法 
{
  "deviceId": string,
  "deviceName": string
}
欄位
deviceId

string (int64 format)

已聲明著作權裝置的裝置 ID。
deviceName

string

裝置的資源名稱，格式為 partners/[PARTNER_ID]/devices/[DEVICE_ID]。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/androidworkprovisioning

詳情請參閱 OAuth 2.0 總覽。