ID

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. Karena instance DeviceIdentifier tidak dapat diubah, Anda tidak dapat menggunakan API untuk mengubah nilai kolom.

Kolom wajib diisi

Perangkat Android

Pendaftaran zero-touch biasanya mengidentifikasi perangkat berdasarkan ID modem seluler IMEI (atau MEID). Namun, untuk mendukung perangkat tanpa modem seluler, seperti tablet, Anda juga dapat mengidentifikasi perangkat menggunakan serangkaian kolom yang berbeda. Tabel berikut menunjukkan kolom yang diperlukan untuk setiap jenis perangkat:

ID Seluler Hanya Wi-Fi Catatan
hardware_id Kolom ini harus berupa nomor IMEI atau MEID. Pendaftaran zero-touch memvalidasi format nilai IMEI saat Anda meneruskannya dalam argumen API. Untuk perangkat dengan lebih dari satu modem seluler, lihat Perangkat SIM ganda.
serialNumber Nomor seri produsen untuk perangkat. Nomor seri peka huruf besar/kecil dan 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 Agar pendaftaran zero-touch berfungsi untuk perangkat khusus Wi-Fi, nilai kolom manufacturer harus cocok dengan nilai bawaan perangkat yang ditampilkan dari Build.MANUFACTURER. Untuk perangkat seluler, kolom manufacturer bersifat opsional, tetapi direkomendasikan, karena memudahkan pelanggan mengidentifikasi perangkat mereka. Lihat referensi nama produsen untuk informasi lebih lanjut.

Jika perangkat tidak dilengkapi modem seluler, misalnya pemindai inventaris tablet atau gudang, gunakan kolom khusus Wi-Fi. Untuk semua perangkat lainnya, gunakan bidang seluler.

Perangkat SIM ganda

Perangkat SIM ganda mencakup dua modem terpisah dan memiliki dua nomor IMEI. Gunakan nomor IMEI terendah karena pendaftaran zero-touch berfungsi lebih andal dengan IMEI terendah.

Perangkat ChromeOS

Untuk perangkat ChromeOS, kumpulan ID yang diperlukan sama untuk perangkat seluler dan Wi-Fi saja:

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 untuk referensi.

Rujuk ke perangkat

Gunakan DeviceIdentifier saat menemukan atau mengklaim perangkat. Anda harus menyertakan kolom wajib diisi 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 khusus 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'}

Pelajari lebih lanjut