DeviceIdentifier
mengenkapsulasi ID hardware untuk mengidentifikasi
perangkat yang diproduksi. Dokumen ini menjelaskan cara menggunakan ID di
API pendaftaran zero-touch.
DeviceIdentifier
menggabungkan metadata atau ID hardware yang diperlukan untuk
mengidentifikasi perangkat secara unik.
Organisasi Anda menyertakan nilai ID perangkat saat mengupload data perangkat melalui portal atau memanggil API.
Kolom wajib diisi
Perangkat Android
Pendaftaran zero-touch biasanya mengidentifikasi perangkat berdasarkan ID modem seluler IMEI (atau MEID). Untuk mendukung perangkat tanpa modem seluler, seperti tablet, Anda juga dapat mengidentifikasi perangkat menggunakan kumpulan kolom yang berbeda. Tabel berikut menunjukkan kolom yang dapat Anda gunakan untuk setiap jenis perangkat:
ID | Seluler | Wi‑Fi saja | Catatan |
---|---|---|---|
hardware_id |
Kolom ini harus berupa nomor IMEI atau MEID. Pendaftaran zero-touch memvalidasi format nilai IMEI saat Anda meneruskannya dalam argumen API. | ||
hardware_id2 |
Kolom ini harus berupa nomor IMEI atau MEID kedua. Pendaftaran zero-touch memvalidasi format nilai IMEI saat Anda meneruskannya dalam argumen API. Untuk informasi tentang perangkat dengan lebih dari satu modem seluler, lihat Perangkat SIM ganda. | ||
serialNumber |
Nomor seri produsen untuk perangkat. Nomor seri peka huruf besar/kecil dan merupakan nilai yang sama dengan yang ditampilkan dari Build.getSerial() . |
||
model |
Nilai model perangkat harus cocok dengan nilai bawaan perangkat yang ditampilkan dari Build.MODEL . Lihat referensi nama model untuk mengetahui daftar nilai yang diizinkan untuk setiap produsen. |
||
manufacturer |
Nilai kolom manufacturer harus cocok dengan nilai bawaan perangkat yang ditampilkan dari Build.MANUFACTURER . Lihat referensi nama produsen untuk informasi selengkapnya. |
Jika mendaftarkan nomor seri, Anda juga harus mendaftarkan produsen dan model untuk memastikan zero-touch dapat mendeteksi perangkat.
Perangkat SIM ganda
Perangkat SIM ganda mencakup dua modem terpisah dan memiliki dua nomor IMEI. Jika hanya mendaftarkan satu IMEI, pilih nomor IMEI dengan angka terendah karena pendaftaran zero-touch berfungsi lebih andal dengan IMEI terendah. Untuk meningkatkan keandalan, Anda juga dapat mendaftarkan IMEI lain, atau nomor seri, produsen, dan model.
Untuk menampilkan IMEI kedua di portal zero-touch:
- Buka tab Perangkat.
- Di sudut kanan atas, di samping tombol Tambahkan Perangkat, klik tiga titik .
- Pilih Sesuaikan tabel.
- Centang kotak untuk IMEI2.
- Klik Simpan.
Perangkat ChromeOS
Untuk perangkat ChromeOS, kumpulan ID yang diperlukan sama untuk perangkat seluler dan khusus Wi-Fi:
ID | Catatan |
---|---|
serialNumber
|
Nomor seri produsen untuk perangkat. |
model
|
Nilai model perangkat harus cocok dengan nilai bawaan perangkat. Lihat daftar nilai model ChromeOS untuk referensi. |
chromeOsAttestedDeviceId
|
ID Perangkat yang Disahkan. Lihat daftar perangkat ChromeOS yang kompatibel sebagai referensi. |
Merujuk ke perangkat
Gunakan DeviceIdentifier
saat menemukan atau mengklaim perangkat. Anda harus menyertakan
kolom wajib yang ditentukan untuk jenis perangkat.
Cuplikan berikut menunjukkan nomor IMEI yang digunakan untuk menelusuri perangkat tertentu
dengan memanggil partners.devices.findByIdentifier
:
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()
Cuplikan berikut menunjukkan cara membuat ID perangkat dengan nomor serial:
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'}
Pelajari lebih lanjut
- Untuk mempelajari ID hardware lebih lanjut, lihat
dokumentasi referensi API untuk
DeviceIdentifier
. - Untuk melihat daftar nama produsen dan model perangkat yang diizinkan, tinjau referensi nama produsen.
- Untuk melihat daftar perangkat ChromeOS yang kompatibel, lihat Pusat Bantuan ChromeOS