Pengenal

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:

  1. Buka tab Perangkat.
  2. Di sudut kanan atas, di samping tombol Tambahkan Perangkat, klik tiga titik .
  3. Pilih Sesuaikan tabel.
  4. Centang kotak untuk IMEI2.
  5. 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