Identificatori

Un elemento DeviceIdentifier incapsula gli ID hardware per identificare un dispositivo prodotto. Questo documento spiega come utilizzare gli identificatori nell'API zero-touch di registrazione.

Un elemento DeviceIdentifier combina i metadati o gli ID hardware necessari per identificare in modo univoco un dispositivo.

La tua organizzazione include i valori degli identificatori del dispositivo quando carichi i dati del dispositivo tramite il portale o quando chiami l'API. Poiché le istanze DeviceIdentifier sono immutabili, non puoi utilizzare l'API per modificare i valori dei campi.

Campi obbligatori

Dispositivi Android

La registrazione zero-touch in genere identifica i dispositivi in base all'ID modem cellulare IMEI (o MEID). Tuttavia, per supportare i dispositivi privi di modem cellulare, come i tablet, puoi anche identificare i dispositivi utilizzando un insieme diverso di campi. La tabella seguente mostra i campi obbligatori per ogni tipo di dispositivo:

Identificatore Rete dati Solo Wi-Fi Note
hardware_id Questo campo deve contenere un numero IMEI o MEID. La registrazione zero-touch convalida il formato dei valori IMEI quando li passi negli argomenti dell'API. Per i dispositivi con più modem cellulare, consulta l'articolo Dispositivi dual SIM.
serialNumber Il numero di serie del produttore del dispositivo. Il numero di serie è sensibile alle maiuscole ed è lo stesso valore restituito da Build.getSerial().
model Il valore del modello del dispositivo deve corrispondere al valore integrato del dispositivo restituito da Build.MODEL. Consulta il riferimento ai nomi dei modelli per un elenco dei valori consentiti per ciascun produttore.
manufacturer Affinché la registrazione zero-touch funzioni per un dispositivo che utilizza solo il Wi-Fi, il valore del campo manufacturer deve corrispondere al valore integrato del dispositivo restituito da Build.MANUFACTURER. Per i dispositivi mobili, il campo manufacturer è facoltativo ma consigliato, poiché consente ai clienti di identificare più facilmente i loro dispositivi. Per ulteriori informazioni, fai riferimento ai nomi dei produttori.

Se il dispositivo non include un modem cellulare, ad esempio un tablet o uno scanner di inventario, utilizza i campi solo Wi-Fi. Per tutti gli altri dispositivi, utilizza i campi della rete cellulare.

Dispositivi dual SIM

Un dispositivo dual SIM include due modem separati e ha due numeri IMEI. Utilizza il numero IMEI più basso perché la registrazione zero-touch funziona in modo più affidabile con il codice IMEI più basso.

Dispositivi ChromeOS

Per i dispositivi ChromeOS, l'insieme di identificatori richiesti è lo stesso sia per i dispositivi mobili sia per i dispositivi che utilizzano solo il Wi-Fi:

Identificatore Note
serialNumber Il numero di serie del produttore del dispositivo.
model Il valore del modello del dispositivo deve corrispondere al valore integrato del dispositivo. Come riferimento, consulta l'elenco dei valori dei modelli di ChromeOS.
chromeOsAttestedDeviceId L'ID dispositivo attestato. Per riferimento, consulta l'elenco dei dispositivi ChromeOS compatibili.

Invita un dispositivo

Usa un DeviceIdentifier per trovare o rivendicare dispositivi. Devi includere i campi obbligatori specificati per il tipo di dispositivo.

Lo snippet seguente mostra un numero IMEI utilizzato per cercare un dispositivo specifico chiamando 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()

Lo snippet seguente mostra come creare un identificatore di dispositivo solo 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'}

Scopri di più