Method: partners.devices.claim

고객을 위해 기기의 소유권을 주장하고 제로터치 등록에 추가합니다. 이미 다른 고객이 기기를 신청했다면 통화에서 오류를 반환합니다.

HTTP 요청

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

URL은 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 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 개요를 참고하세요.