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ù
- Per scoprire di più sugli identificatori hardware, consulta la
Documentazione di riferimento API per
DeviceIdentifier
. - Per un elenco dei nomi dei produttori e dei modelli di dispositivi consentiti, consulta la sezione riferimento ai nomi dei produttori.
- Per visualizzare un elenco dei dispositivi ChromeOS compatibili, consulta le Centro assistenza ChromeOs