식별자

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

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

조직은 포털을 통해 기기 데이터를 업로드하거나 API를 호출할 때 기기 식별자 값을 포함합니다.

필수 입력란

Android 기기

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

식별자 모바일 데이터 Wi‑Fi 전용 참고
hardware_id 이 필드는 IMEI 또는 MEID 번호여야 합니다. 제로터치 등록은 IMEI 값을 API 인수에 전달할 때 IMEI 값의 형식을 검증합니다.
hardware_id2 이 필드는 보조 IMEI 또는 MEID 번호여야 합니다. 제로터치 등록은 IMEI 값을 API 인수에 전달할 때 IMEI 값의 형식을 검증합니다. 셀룰러 모뎀이 2개 이상 있는 기기에 관한 자세한 내용은 듀얼 SIM 기기를 참고하세요.
serialNumber 기기의 제조업체 일련번호입니다. 일련번호는 대소문자를 구분하며 Build.getSerial()에서 반환되는 값과 동일합니다.
model 기기 모델 값은 Build.MODEL에서 반환된 기기의 내장 값과 일치해야 합니다. 각 제조업체에 허용되는 값 목록은 모델 이름 참조를 참고하세요.
manufacturer manufacturer 필드 값은 Build.MANUFACTURER에서 반환된 기기의 내장 값과 일치해야 합니다. 자세한 내용은 제조업체 이름 참조를 확인하세요.

일련번호를 등록하는 경우 제로터치가 기기를 감지할 수 있도록 제조업체와 모델도 등록해야 합니다.

듀얼 SIM 기기

듀얼 SIM 기기에는 2개의 개별 모뎀과 2개의 IMEI 번호가 있습니다. IMEI를 하나만 등록하는 경우 숫자가 가장 낮은 IMEI 번호를 사용하는 것이 좋습니다. 제로터치 등록은 가장 낮은 IMEI에서 더 안정적으로 작동하기 때문입니다. 안정성을 높이려면 다른 IMEI 또는 일련번호, 제조업체, 모델을 추가로 등록할 수 있습니다.

제로터치 포털에 두 번째 IMEI를 표시하려면 다음 단계를 따르세요.

  1. 기기 탭으로 이동합니다.
  2. 오른쪽 상단의 기기 추가 버튼 옆에 있는 점 3개 를 클릭합니다.
  3. 표 맞춤설정을 선택합니다.
  4. IMEI2의 체크박스를 선택합니다.
  5. 저장을 클릭합니다.

ChromeOS 기기

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

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

기기 참조

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

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

자바

// 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()

다음 스니펫은 일련번호로 기기 식별자를 만드는 방법을 보여줍니다.

자바

// 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 고객센터를 참고하세요.