식별자

DeviceIdentifier는 하드웨어 ID를 캡슐화하여 제조된 기기를 식별합니다. 이 문서에서는 제로터치 등록 API에서 식별자를 사용하는 방법을 설명합니다.

DeviceIdentifier는 기기를 고유하게 식별하는 데 필요한 하드웨어 메타데이터 또는 ID를 결합합니다.

조직은 포털을 통해 기기 데이터를 업로드하거나 API를 호출할 때 기기 식별자 값을 포함합니다. DeviceIdentifier 인스턴스는 변경할 수 없으므로 API를 사용하여 필드 값을 변경할 수 없습니다.

필수 입력란

Android 기기

제로터치 등록은 일반적으로 IMEI (또는 MEID) 모바일 모뎀 ID로 기기를 식별합니다. 그러나 태블릿과 같이 셀룰러 모뎀이 없는 기기를 지원하려면 다른 필드 세트를 사용하여 기기를 식별할 수도 있습니다. 다음 표는 각 기기 유형에 필요한 필드를 보여줍니다.

식별자 모바일 데이터 Wi‐Fi 전용 Notes
hardware_id 이 입력란은 IMEI 또는 MEID 번호여야 합니다. 제로터치 등록은 IMEI 값을 API 인수로 전달할 때 IMEI 값의 형식을 검증합니다. 모바일 모뎀이 두 개 이상인 기기는 듀얼 SIM 기기를 참고하세요.
serialNumber 기기 제조업체의 일련번호입니다. 일련번호는 대소문자를 구분하며 Build.getSerial()에서 반환된 값과 동일합니다.
model 기기 모델 값은 Build.MODEL에서 반환된 기기의 내장 값과 일치해야 합니다. 각 제조업체에 허용되는 값 목록은 모델 이름 참조를 확인하세요.
manufacturer Wi‐Fi 전용 기기에서 제로터치 등록이 작동하려면 manufacturer 필드 값이 Build.MANUFACTURER에서 반환된 기기의 내장 값과 일치해야 합니다. 휴대기기의 경우 manufacturer 입력란은 선택사항이지만 고객이 기기를 쉽게 식별할 수 있으므로 사용하는 것이 좋습니다. 자세한 내용은 제조업체 이름 참고 자료를 확인하세요.

기기에 셀룰러 모뎀이 없는 경우(예: 태블릿 또는 창고형 인벤토리 스캐너) Wi-Fi 전용 필드를 사용합니다. 다른 모든 기기의 경우 셀룰러 필드를 사용합니다.

듀얼 SIM 기기

듀얼 SIM 기기에는 2개의 개별 모뎀과 2개의 IMEI 번호가 있습니다. 숫자가 가장 낮은 IMEI 번호를 사용합니다. 제로터치 등록이 가장 낮은 IMEI로 더 안정적으로 작동하기 때문입니다.

ChromeOS 기기

ChromeOS 기기의 경우 필수 식별자 집합이 셀룰러 및 Wi-Fi 전용 기기와 동일합니다.

식별자 Notes
serialNumber 기기의 제조업체 일련번호입니다.
model 기기 모델 값은 기기의 내장 값과 일치해야 합니다. 자세한 내용은 ChromeOS 모델 값 목록을 참고하세요.
chromeOsAttestedDeviceId 증명된 기기 ID입니다. 자세한 내용은 호환되는 ChromeOS 기기 목록을 참고하세요.

기기 참조

기기를 찾거나 소유권을 주장할 때 DeviceIdentifier를 사용합니다. 기기 유형에 지정된 필수 필드를 포함해야 합니다.

다음 스니펫은 partners.devices.findByIdentifier를 호출하여 특정 기기를 검색하는 데 사용되는 IMEI 번호를 보여줍니다.

Java

// Create a DeviceIdentifier.
DeviceIdentifier deviceIdentifier = new DeviceIdentifier();
deviceIdentifier.setImei("123456789012347");

// Perform the search using the zero-touch enrollment API.
FindDevicesByDeviceIdentifierRequest body = new FindDevicesByDeviceIdentifierRequest();
body.setLimit(1L);
body.setDeviceIdentifier(deviceIdentifier);

FindDevicesByDeviceIdentifierResponse response = service
    .partners()
    .devices()
    .findByIdentifier(PARTNER_ID, body)
    .execute();

.NET

// Create a DeviceIdentifier.
var deviceIdentifier = new DeviceIdentifier
{
    Imei = "123456789012347"
};

// Perform the search using the zero-touch enrollment API.
var body = new FindDevicesByDeviceIdentifierRequest
{
    Limit = 1,
    DeviceIdentifier = deviceIdentifier
};
var response = service.Partners.Devices.FindByIdentifier(body, PartnerId).Execute();

Python

# Create a DeviceIdentifier.
device_identifier = {'imei':'123456789012347'}

# Perform the search using the zero-touch enrollment API.
response = service.partners().devices().findByIdentifier(
    partnerId=PARTNER_ID, body={'deviceIdentifier':device_identifier, \
    'limit':1}).execute()

다음 스니펫은 Wi‐Fi 전용 기기 식별자를 만드는 방법을 보여줍니다.

Java

// Create a device identifier to find a Wi-Fi-only device.
DeviceIdentifier deviceIdentifier = new DeviceIdentifier();
deviceIdentifier.setManufacturer("Honeywell");
deviceIdentifier.setModel("VM1A");
deviceIdentifier.setSerialNumber("ABcd1235678");

.NET

// Create a device identifier to find a Wi-Fi-only device.
var deviceIdentifier = new DeviceIdentifier
{
    Manufacturer = "Honeywell",
    Model = "VM1A",
    SerialNumber = "ABcd1235678"
};

Python

# Create a device identifier to find a Wi-Fi-only device.
device_identifier = {'manufacturer':'Honeywell', \
    'model':'VM1A', 'serialNumber':'ABcd1235678'}

자세히 알아보기

  • 하드웨어 식별자에 관한 자세한 내용은 DeviceIdentifier의 API 참조 문서를 확인하세요.
  • 허용되는 제조업체 이름과 기기 모델의 목록을 보려면 제조업체 이름 참조를 검토하세요.
  • 호환되는 ChromeOS 기기 목록을 보려면 ChromeOs 고객센터를 참고하세요.