Identificadores

Un DeviceIdentifier encapsula los IDs de hardware para identificar un manufacturado. En este documento, se explica cómo trabajar con identificadores en el con la API de inscripción automática.

Un elemento DeviceIdentifier combina los metadatos o los IDs de hardware necesarios para identificar un dispositivo.

Tu organización incluye los valores del identificador de dispositivo cuando subes el dispositivo. datos sensibles a través del portal o llamando a la API. Porque DeviceIdentifier instancias son inmutables, no puedes usar la API para cambiar los valores de los campos.

Campos obligatorios

Dispositivos Android

La inscripción automática suele identificar los dispositivos por el IMEI (o MEID) los IDs de los módems móviles. Sin embargo, para admitir dispositivos sin módems móviles, como tablets, también puedes identificar dispositivos mediante un conjunto diferente de campos. El La siguiente tabla muestra los campos obligatorios para cada tipo de dispositivo:

Identificador Móvil Solo Wi-Fi Notas
hardware_id Este campo debe ser un número IMEI o MEID. La inscripción automática valida el formato de los valores de IMEI cuando los pasas en los argumentos de la API. Para dispositivos con más de un módem celular, consulta Dispositivos con SIM dual.
serialNumber Es el número de serie del fabricante del dispositivo. El número de serie distingue mayúsculas de minúsculas y es el mismo valor que se muestra en Build.getSerial().
model El valor del modelo de dispositivo debe coincidir con el valor integrado del dispositivo que muestra Build.MODEL. Consulta la referencia de los nombres de modelos para obtener una lista de los valores permitidos para cada fabricante.
manufacturer Para que la inscripción automática funcione en un dispositivo que solo funciona con Wi-Fi, el valor del campo manufacturer debe coincidir con el valor integrado del dispositivo que muestra Build.MANUFACTURER. En el caso de los dispositivos móviles, el campo manufacturer es opcional, pero se recomienda, ya que facilita que los clientes identifiquen sus dispositivos. Consulta la referencia de los nombres de fabricantes para obtener más información.

Si el dispositivo no incluye un módem celular, como una tablet o el escáner de inventario del almacén, usa los campos de solo Wi-Fi. Para todos los demás dispositivos, usar los campos móviles.

Dispositivos con doble tarjeta SIM

Un dispositivo con tarjeta SIM dual incluye dos módems discretos y dos números IMEI. Usa el número de IMEI más bajo numéricamente, ya que la inscripción automática funciona mejor de forma confiable con el IMEI más bajo.

Dispositivos ChromeOS

En los dispositivos ChromeOS, el conjunto de identificadores obligatorios es el mismo para los datos móviles y dispositivos que solo usan Wi-Fi:

Identificador Notas
serialNumber Es el número de serie del fabricante del dispositivo.
model El valor del modelo del dispositivo debe coincidir con el valor integrado. Consulta la lista de valores de modelos de ChromeOS. como referencia.
chromeOsAttestedDeviceId El ID del dispositivo presentado. Consulta la lista de ChromeOS compatible para dispositivos referencia.

Cómo hacer referencia a un dispositivo

Usa un DeviceIdentifier cuando busques o reclames dispositivos. Es necesario incluir en los campos obligatorios especificados para el tipo de dispositivo.

En el siguiente fragmento, se muestra un número IMEI que se usa para buscar un dispositivo específico Para ello, llama a 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()

En el siguiente fragmento, se muestra cómo crear un dispositivo solo con Wi-Fi identificador:

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'}

Más información