Method: partners.devices.claimAsync
HTTP 请求
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync
网址采用 gRPC 转码语法。
路径参数
参数 |
partnerId |
string (int64 format)
必需。转销商合作伙伴的 ID。
|
请求正文
请求正文中包含结构如下的数据:
字段 |
claims[] |
object (PartnerClaim )
必需。设备声明列表。
|
响应正文
如果成功,则响应正文包含一个 Operation
实例。
授权作用域
需要以下 OAuth 范围:
https://www.googleapis.com/auth/androidworkprovisioning
如需了解详情,请参阅 OAuth 2.0 概览。
PartnerClaim
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
可选。必须且只能为 ChromeOS 设备设置。
|
联合字段 customer 。必需。声明设备所有权的客户。customer 只能是下列其中一项: |
customerId |
string (int64 format)
声明设备所有权的客户的 ID。
|
googleWorkspaceCustomerId |
string
Google Workspace 客户 ID。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-08-29。
[null,null,["最后更新时间 (UTC):2024-08-29。"],[[["This endpoint `POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync` enables partners to asynchronously claim a batch of devices for a customer, adding them to zero-touch enrollment."],["The request requires a `partnerId` path parameter, which is the reseller partner's ID, and a request body with a list of device claims within the `claims` field."],["Each device claim is identified by a `PartnerClaim` object, which contains the `deviceIdentifier`, `sectionType`, `deviceMetadata`, and a customer identifier in the form of `customerId` or `googleWorkspaceCustomerId`."],["The `PartnerClaim` object optionally includes a `preProvisioningToken` and is required to complete the request."],["A successful request returns an `Operation` object, indicating that the long-running operation has been initiated."]]],["This outlines how to claim devices for a customer asynchronously via the Android zero-touch enrollment API. Use a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync`, providing the required `partnerId`. The request body, structured in JSON, includes a list of device `claims` with each claim containing the `deviceIdentifier`, `sectionType`, `deviceMetadata`, and the required customer's ID (`customerId` or `googleWorkspaceCustomerId`). The `preProvisioningToken` field is required only for ChromeOS devices. The response body contains an `Operation`.\n"]]