Method: partners.devices.claimAsync
비동기식으로 고객의 기기 배치에 대한 소유권을 주장합니다. 제로터치 등록에 기기를 추가합니다. 자세한 내용은 장기 실행 일괄 작업을 참고하세요.
HTTP 요청
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claimAsync
URL은 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
선택사항입니다. Chrome OS 기기에만 설정해야 하며 설정할 수 있습니다.
|
통합 필드 customer . 필수 항목입니다. 기기 소유권을 주장한 고객입니다. customer 은 다음 중 하나여야 합니다. |
customerId |
string (int64 format)
기기 소유권을 주장한 고객의 ID입니다.
|
googleWorkspaceCustomerId |
string
Google Workspace 고객 ID입니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-08-29(UTC)
[null,null,["최종 업데이트: 2024-08-29(UTC)"],[[["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"]]