DeviceIdentifier
는 하드웨어 ID를 캡슐화하여
제조된 기기를 말합니다. 이 문서에서는
제로터치 등록 API
DeviceIdentifier
는 고유하게 필요한 하드웨어 메타데이터 또는 ID를 결합합니다.
기기를 식별합니다.
기기를 업로드할 때 조직에서 기기 식별자 값을 포함함
API를 호출하기만 하면 됩니다 이유: DeviceIdentifier
인스턴스
API를 사용하여 필드 값을 변경할 수 없습니다.
필수 입력란
Android 기기
제로터치 등록은 일반적으로 IMEI (또는 MEID)로 기기를 식별합니다. 셀룰러 모뎀 ID 그러나 다른 입력란 집합을 사용하여 기기를 식별할 수도 있습니다. 이 다음 표에는 각 기기 유형에 필요한 필드가 나와 있습니다.
식별자 | 모바일 데이터 | Wi‐Fi 전용 | 참고 |
---|---|---|---|
hardware_id |
이 입력란은 IMEI 또는 MEID 번호여야 합니다. 제로터치 등록은 IMEI 값의 형식을 API 인수로 전달할 때 그 형식을 검증합니다. 셀룰러 모뎀이 두 개 이상인 기기는 듀얼 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 전용 기기:
식별자 | 참고 |
---|---|
serialNumber
|
기기의 제조업체 일련번호 있습니다. |
model
|
기기 모델 값이 기기의 기본 제공 값입니다. ChromeOS 모델 값 목록을 참고하세요. 참고하시기 바랍니다. |
chromeOsAttestedDeviceId
|
증명된 기기 ID입니다. 자세한 내용은 호환되는 ChromeOS 기기 참조 |
기기 참조
기기를 찾거나 소유권을 주장할 때 DeviceIdentifier
를 사용합니다. 이때
기기 유형에 지정된 필수 입력란입니다.
다음 스니펫은 특정 기기를 검색하는 데 사용되는 IMEI 번호를 보여줍니다.
다음과 같이 partners.devices.findByIdentifier
를 호출합니다.
자바
// 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 전용 기기를 만드는 방법을 보여줍니다. 식별자:
자바
// 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 고객센터