Identificatori

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

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

La tua organizzazione include i valori degli identificatori dei dispositivi quando carica i dati del dispositivo tramite il portale o chiama l'API.

Campi obbligatori

Dispositivi Android

In genere, la registrazione zero-touch identifica i dispositivi in base agli ID modem cellulare IMEI (o MEID). Per supportare i dispositivi senza modem cellulari, come i tablet, puoi anche identificare i dispositivi utilizzando un insieme diverso di campi. La tabella seguente mostra i campi che puoi utilizzare per ogni 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 agli argomenti dell'API.
hardware_id2 Questo campo deve contenere un secondo numero IMEI o MEID. La registrazione zero-touch convalida il formato dei valori IMEI quando li passi agli argomenti dell'API. Per informazioni sui dispositivi con più di un modem 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 predefinito del dispositivo restituito da Build.MODEL. Consulta il riferimento ai nomi dei modelli per un elenco dei valori consentiti per ciascun produttore.
manufacturer Il valore del campo manufacturer deve corrispondere al valore predefinito del dispositivo restituito da Build.MANUFACTURER. Per ulteriori informazioni, consulta la sezione di riferimento relativa ai nomi dei produttori.

Se registri il numero di serie, devi registrare anche il produttore e il modello per assicurarti che la registrazione zero-touch riesca a rilevare il dispositivo.

Dispositivi dual SIM

Un dispositivo dual SIM include due modem separati e ha due numeri IMEI. Se registri un solo IMEI, preferisci il numero IMEI numerico più basso, poiché la registrazione zero-touch funziona in modo più affidabile con l'IMEI più basso. Per aumentare la affidabilità, puoi anche registrare l'altro IMEI o il numero di serie, il produttore e il modello.

Per visualizzare il secondo IMEI nel portale della registrazione zero-touch:

  1. Vai alla scheda Dispositivi.
  2. Nell'angolo in alto a destra, accanto al pulsante Aggiungi dispositivo, fai clic sui tre puntini .
  3. Seleziona Personalizza tabella.
  4. Seleziona la casella di controllo per IMEI2.
  5. Fai clic su Salva.

Dispositivi ChromeOS

Per i dispositivi ChromeOS, l'insieme di identificatori richiesti è lo stesso per i dispositivi con rete mobile e solo 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. Consulta l'elenco dei valori del modello ChromeOS per riferimento futuro.
chromeOsAttestedDeviceId L'ID dispositivo attestato. Consulta l'elenco dei dispositivi ChromeOS compatibili come riferimento.

Fare riferimento a un dispositivo

Usa un DeviceIdentifier quando trovi o rivendichi dispositivi. Devi includere i campi obbligatori specificati per il tipo di dispositivo.

Lo snippet che segue mostra un numero IMEI utilizzato per cercare un dispositivo specifico chiamando partners.devices.findByIdentifier:

Java.NETPython
// 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();
 
// 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();
 
# 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 dispositivo con un numero di serie:

Java.NETPython
// Create a device identifier to find a Wi-Fi-only device.
DeviceIdentifier deviceIdentifier = new DeviceIdentifier();
deviceIdentifier.setManufacturer("Honeywell");
deviceIdentifier.setModel("VM1A");
deviceIdentifier.setSerialNumber("ABcd1235678");
 
// Create a device identifier to find a Wi-Fi-only device.
var deviceIdentifier = new DeviceIdentifier
{
    Manufacturer = "Honeywell",
    Model = "VM1A",
    SerialNumber = "ABcd1235678"
};
 
# Create a device identifier to find a Wi-Fi-only device.
device_identifier = {'manufacturer':'Honeywell', \
    'model':'VM1A', 'serialNumber':'ABcd1235678'}

Scopri di più