Method: partners.devices.claimAsync
HTTP 要求
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
partnerId |
string (int64 format)
必要欄位。經銷商合作夥伴的 ID。
|
回應主體
如果成功,回應主體會包含 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 )
必要欄位。必要欄位。裝置的裝置 ID。
|
sectionType |
enum (DeviceProvisioningSectionType )
必要欄位。裝置佈建記錄的部分類型。
|
deviceMetadata |
object (DeviceMetadata )
必要欄位。要附加到索賠的裝置中繼資料。
|
preProvisioningToken |
string
選用設定。只能在 Chrome OS 裝置上設定,且只能設定一次。
|
聯集欄位 customer 。必要欄位。要領取裝置的客戶。customer 只能是下列其中一項: |
customerId |
string (int64 format)
要領取裝置的客戶 ID。
|
googleWorkspaceCustomerId |
string
Google Workspace 客戶 ID。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-29 (世界標準時間)。
[null,null,["上次更新時間: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"]]