Identificadores

Un DeviceIdentifier encapsula los IDs de hardware para identificar un dispositivo fabricado. En este documento, se explica cómo trabajar con identificadores en la API de inscripción sin contacto.

Un DeviceIdentifier combina los metadatos o los IDs de hardware necesarios para identificar un dispositivo de forma única.

Tu organización incluye los valores del identificador de dispositivo cuando sube datos del dispositivo a través del portal o llama a la API.

Campos obligatorios

Dispositivos Android

Por lo general, la inscripción sin intervención identifica los dispositivos por los IDs de los módems celulares IMEI (o MEID). Para admitir dispositivos sin módems celulares, como las tablets, también puedes identificar dispositivos con un conjunto diferente de campos. En la siguiente tabla, se muestran los campos que puedes usar para cada tipo de dispositivo:

Identificador Móvil Solo Wi-Fi Notas
hardware_id Este campo debe ser un número de IMEI o MEID. La inscripción sin intervención valida el formato de los valores de IMEI cuando los pasas en argumentos de API.
hardware_id2 Este campo debe ser un segundo número de IMEI o MEID. La inscripción sin intervención valida el formato de los valores de IMEI cuando los pasas en argumentos de API. Para obtener información sobre los dispositivos con más de un módem celular, consulta Dispositivos con doble SIM.
serialNumber 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 del dispositivo debe coincidir con el valor integrado del dispositivo que se muestra en Build.MODEL. Consulta la referencia de nombres de modelos para obtener una lista de los valores permitidos para cada fabricante.
manufacturer El valor del campo manufacturer debe coincidir con el valor integrado del dispositivo que se muestra en Build.MANUFACTURER. Consulta la referencia de nombres de fabricantes para obtener más información.

Si registras el número de serie, también debes registrar el fabricante y el modelo para asegurarte de que la inscripción automática pueda detectar el dispositivo.

Dispositivos con doble SIM

Un dispositivo con doble SIM incluye dos módems discretos y tiene dos números IMEI. Si solo registras un IMEI, prefiere el número IMEI más bajo numéricamente, ya que la inscripción sin contacto funciona de manera más confiable con el IMEI más bajo. Para aumentar la confiabilidad, también puedes registrar el otro IMEI, el número de serie, el fabricante y el modelo.

Para mostrar el segundo IMEI en el portal de inscripción automática, haz lo siguiente:

  1. Ve a la pestaña Devices.
  2. En la esquina superior derecha, junto al botón Agregar dispositivo, haz clic en los tres puntos .
  3. Selecciona Personalizar tabla.
  4. Selecciona la casilla de verificación correspondiente a IMEI2.
  5. Haz clic en Guardar.

Dispositivos ChromeOS

En el caso de los dispositivos ChromeOS, el conjunto de identificadores obligatorios es el mismo para los dispositivos solo con Wi-Fi y con red celular:

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

Cómo hacer referencia a un dispositivo

Usa un DeviceIdentifier cuando encuentres o reclames dispositivos. Debes incluir 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 llamando 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 identificador de dispositivo con un número de serie:

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