REST Resource: customers.devices

리소스: Device

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

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

string (int64 format)

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

object (DeviceIdentifier)

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

string

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

object (DeviceMetadata)

기기에 연결된 메타데이터입니다. 키-값 쌍으로 구성됩니다.
claims[]

object (DeviceClaim)

출력 전용. 프로비저닝이 기기의 클레임. 제로터치 등록을 신청한 기기는 SECTION_TYPE_ZERO_TOUCH 유형의 클레임이 있습니다. customers.devices.unclaim를 호출하여 제로터치 등록에서 기기를 삭제합니다.
configuration

string

customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] 형식으로 기기에 적용된 구성입니다. 기기에 구성이 적용되지 않은 경우 값은 null입니다.

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.
}
필드
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 번호.

기기 유형

기기의 운영체제

열거형
DEVICE_TYPE_ANDROID Android 기기
DEVICE_TYPE_CHROME_OS Chrome OS 기기

기기 메타데이터

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

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

map (key: string, value: string)

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

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

기기 소유권 주장

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

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

enum (DeviceProvisioningSectionType)

출력 전용. 기기에서 제기된 청구 유형입니다.
ownerCompanyId

string (int64 format)

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

string

Chrome OS 기기를 소유한 Google Workspace 계정의 ID입니다.
additionalService

enum (AdditionalService)

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

기기 프로비저닝 섹션 유형

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

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

추가 서비스

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

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

방법

applyConfiguration

 기기에 구성을 적용하여 제로터치 등록을 위해 기기를 등록합니다.

get

 기기의 세부정보를 가져옵니다.

list

 고객의 기기를 나열합니다.

removeConfiguration

 기기에서 구성을 삭제합니다.

unclaim

 고객의 기기 등록을 해제하고 제로터치 등록에서 삭제합니다.