Identificatori

Un DeviceIdentifier incapsula gli ID hardware per identificare un prodotto. Questo documento spiega come utilizzare gli identificatori in l'API per la registrazione zero-touch.

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

La tua organizzazione include i valori degli identificatori dei dispositivi durante il caricamento del dispositivo tramite il portale o chiamando l'API. Poiché DeviceIdentifier istanze sono immutabili, non puoi usare l'API per modificare i valori dei campi.

Campi obbligatori

Dispositivi Android

La registrazione zero-touch in genere identifica i dispositivi in base al codice IMEI (o MEID) ID modem cellulare. Tuttavia, per supportare i dispositivi senza modem cellulare, ad esempio tablet, puoi anche identificare i dispositivi utilizzando un insieme diverso di campi. La la seguente tabella mostra i campi obbligatori per ciascun tipo di dispositivo:

Identificatore Cellulare Solo Wi-Fi Note
hardware_id Questo campo deve essere 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ù di un modem di rete cellulare, vedi 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 i nomi di modelli per un elenco dei valori consentiti per ciascun produttore.
manufacturer Affinché la registrazione zero-touch funzioni sui dispositivi che utilizzano 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 propri dispositivi. Per ulteriori informazioni, consulta il riferimento dei nomi dei produttori.

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

Dispositivi dual SIM

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

Dispositivi ChromeOS

Per i dispositivi ChromeOS, il set di identificatori obbligatori è lo stesso per la rete mobile e solo Wi-Fi:

Identificatore Note
serialNumber Il numero di serie del produttore per dispositivo.
model Il valore del modello del dispositivo deve corrispondere a quello del un valore integrato. Consulta l'elenco dei valori dei modelli di ChromeOS come riferimento.
chromeOsAttestedDeviceId L'ID dispositivo attestato. Consulta l'elenco di ChromeOS compatibile dispositivi per riferimento.

Fai riferimento a un dispositivo

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

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

Il seguente snippet mostra come creare un dispositivo che utilizza solo il Wi-Fi identificatore:

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ù