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)

必需。必需。要声明所有权的设备的设备标识符。
sectionType

enum (DeviceProvisioningSectionType)

必需。设备的配置记录的区段类型。
deviceMetadata

object (DeviceMetadata)

（可选）要附加到设备的元数据。
preProvisioningToken

string

（可选）必须且只能为 Chrome 操作系统设备设置。
联合字段 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 概览。