REST Resource: partners.devices

리소스: 기기

제로터치 등록에 등록된 Android 또는 ChromeOS 기기

JSON 표현 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ]
}
필드
deviceId

string (int64 format)

출력 전용입니다. 기기의 ID입니다. 서버에서 할당됩니다.
deviceIdentifier

object (DeviceIdentifier)

제조된 기기를 식별하는 하드웨어 ID입니다. 자세한 내용은 식별자를 참고하세요.
name

string

출력 전용입니다. partners/[PARTNER_ID]/devices/[DEVICE_ID] 형식의 API 리소스 이름입니다. 서버에서 할당됩니다.
deviceMetadata

object (DeviceMetadata)

기기에 연결된 메타데이터입니다. 키-값 쌍으로 구조화됩니다. 자세한 내용은 기기 메타데이터를 참고하세요.
claims[]

object (DeviceClaim)

출력 전용입니다. 프로비저닝이 기기의 소유권을 주장합니다. 제로터치 등록을 위해 소유권이 주장된 기기에는 SECTION_TYPE_ZERO_TOUCH 유형의 소유권 주장이 있습니다. partners.devices.unclaim 또는 partners.devices.unclaimAsync를 호출하여 제로터치 등록에서 기기를 삭제합니다.

DeviceIdentifier

하드웨어 및 제품 ID를 캡슐화하여 제조된 기기를 식별합니다. 식별자 집합에 관한 요구사항을 알아보려면 식별자를 참고하세요.

JSON 표현 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.

  // Union field hardware_id2 can be only one of the following:
  "imei2": string,
  "meid2": string
  // End of list of possible types for union field hardware_id2.
}
필드
serialNumber

string

기기의 제조업체 일련번호입니다. 이 값은 기기 모델마다 고유하지 않을 수 있습니다.
manufacturer

string

기기 제조업체 이름 android.os.Build.MANUFACTURER에서 반환된 기기의 내장 값과 일치합니다. 허용되는 값은 Android 제조업체에 나와 있습니다.
model

string

기기 모델의 이름입니다. 허용되는 값은 Android 모델 및 Chrome OS 모델에 나와 있습니다.
deviceType

enum (DeviceType)

기기 유형
chromeOsAttestedDeviceId

string

OEM에서 제공하고 생산 및 판매 프로세스를 통해 전달되는 식별자입니다. Chrome OS 기기에만 적용됩니다.
통합 필드 hardware_id. 모뎀 ID를 기반으로 하는 하드웨어 ID입니다. hardware_id은 다음 중 하나여야 합니다.
imei

string

기기의 IMEI 번호 입력 시 유효성이 검사됩니다.
meid

string

기기의 MEID 번호입니다.
통합 필드 hardware_id2. 듀얼 SIM 기기의 두 번째 하드웨어 ID입니다. 설정하는 경우 첫 번째 하드웨어 ID와 동일한 식별자 유형이어야 합니다. hardware_id2은 다음 중 하나여야 합니다.
imei2

string

기기의 두 번째 IMEI 번호입니다.
meid2

string

기기의 두 번째 MEID 번호입니다.

DeviceType

기기의 운영체제

열거형
DEVICE_TYPE_ANDROID Android 기기
DEVICE_TYPE_CHROME_OS ChromeOS 기기

DeviceMetadata

Device에 연결할 수 있는 메타데이터 항목입니다. 자세한 내용은 기기 메타데이터를 참고하세요.

JSON 표현 
{
  "entries": {
    string: string,
    ...
  }
}
필드
entries

map (key: string, value: string)

키-값 쌍으로 기록된 메타데이터 항목입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

DeviceClaim

리셀러가 고객을 위해 소유권을 주장한 기기의 레코드입니다. 제로터치 등록에 대해 요청된 기기에는 SECTION_TYPE_ZERO_TOUCH 유형의 클레임이 있습니다. 자세한 내용은 고객을 위해 기기 소유권 주장하기를 참고하세요.

JSON 표현 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
필드
sectionType

enum (DeviceProvisioningSectionType)

출력 전용입니다. 기기에 제기된 소유권 주장 유형입니다.
ownerCompanyId

string (int64 format)

기기를 구매한 고객의 ID입니다.
googleWorkspaceCustomerId

string

ChromeOS 기기를 소유한 Google Workspace 계정의 ID입니다.
resellerId

string (int64 format)

기기의 소유권을 주장한 리셀러의 ID입니다.
additionalService

enum (AdditionalService)

기기에 등록된 추가 서비스입니다.

DeviceProvisioningSectionType

프로비저닝 레코드의 섹션 유형입니다.

열거형
SECTION_TYPE_SIM_LOCK SIM 잠금 섹션 유형입니다.
SECTION_TYPE_ZERO_TOUCH 제로터치 등록 섹션 유형입니다.

AdditionalService

기기에 등록된 추가 서비스입니다.

열거형
DEVICE_PROTECTION Android Enterprise Essentials라고도 하는 기기 보호 서비스 기기 보호 서비스로 기기를 소유권 주장하려면 파트너십팀에 등록해야 합니다.

메서드

claim

 고객의 기기를 소유권 주장하고 제로터치 등록에 추가합니다.

claimAsync

 고객의 기기 일괄 항의를 비동기식으로 처리합니다.

findByIdentifier

 IMEI와 같은 하드웨어 식별자를 사용하여 기기를 찾습니다.

findByOwner

 고객이 소유권을 주장한 기기를 찾습니다.

get

 기기를 가져옵니다.

metadata

 기기와 연결된 리셀러 메타데이터를 업데이트합니다.

unclaim

 고객으로부터 기기 소유권 주장을 취소하고 제로터치 등록에서 기기를 삭제합니다.

unclaimAsync

 고객의 기기 일괄 소유권 주장을 비동기식으로 취소합니다.

updateMetadataAsync

 기기 일괄에 연결된 리셀러 메타데이터를 업데이트합니다.