Pengenal (ID)

DeviceIdentifier mengenkapsulasi ID hardware untuk mengidentifikasi perangkat produksi. Dokumen ini menjelaskan cara bekerja dengan pengenal dalam API pendaftaran zero-touch.

DeviceIdentifier menggabungkan metadata atau ID hardware yang diperlukan untuk mengidentifikasi perangkat.

Organisasi Anda menyertakan nilai ID perangkat saat mengupload perangkat data melalui portal atau memanggil API. Karena DeviceIdentifier instance tidak dapat diubah, Anda tidak dapat menggunakan API untuk mengubah nilai kolom.

Kolom wajib diisi

Perangkat Android

Pendaftaran zero-touch biasanya mengidentifikasi perangkat berdasarkan IMEI (atau MEID) ID modem seluler. Tetapi untuk mendukung perangkat tanpa modem seluler, seperti komputer tablet, Anda juga dapat mengidentifikasi perangkat menggunakan sekumpulan bidang yang berbeda. Tujuan tabel berikut menampilkan kolom yang wajib diisi 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. Untuk perangkat yang memiliki 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 bagi 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 tablet atau pemindai inventaris gudang, gunakan kolom khusus Wi-Fi. Untuk semua perangkat lainnya, menggunakan bidang seluler.

Perangkat SIM ganda

Perangkat SIM ganda mencakup dua modem terpisah dan memiliki dua nomor IMEI. Gunakan nomor IMEI terendah secara numerik karena pendaftaran zero-touch lebih efektif dapat diandalkan dengan IMEI terendah.

Perangkat ChromeOS

Untuk perangkat ChromeOS, kumpulan ID yang diperlukan sama dengan kumpulan ID seluler dan perangkat khusus Wi-Fi:

ID Catatan
serialNumber Nomor seri produsen untuk perangkat seluler.
model Nilai model perangkat harus sesuai dengan nilai bawaan. Lihat daftar nilai model ChromeOS sebagai referensi.
chromeOsAttestedDeviceId ID Perangkat yang Dibuktikan. Lihat daftar ChromeOS yang kompatibel perangkat untuk alamat IP internal.

Rujuk perangkat

Gunakan DeviceIdentifier saat menemukan atau mengklaim perangkat. Anda perlu 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 perangkat khusus Wi-Fi ID:

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