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에서 제공하는 식별자로, 생산 및 판매 프로세스를 통해 전달됩니다. ChromeOS 기기에만 적용됩니다.

통합 필드 hardware_id. 모뎀 ID를 기반으로 하는 하드웨어 ID hardware_id은 다음 중 하나여야 합니다.
imei

string

기기의 IMEI 번호 입력 시 검증되었습니다.

meid

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,
  "additionalService": enum (AdditionalService)
}
필드
sectionType

enum (DeviceProvisioningSectionType)

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

ownerCompanyId

string (int64 format)

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

googleWorkspaceCustomerId

string

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

additionalService

enum (AdditionalService)

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

DeviceProvisioningSectionType

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

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

AdditionalService

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

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

메서드

applyConfiguration

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

get

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

list

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

removeConfiguration

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

unclaim

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