Identificadores

Um DeviceIdentifier encapsula IDs de hardware para identificar um dispositivo fabricado. Este documento explica como trabalhar com identificadores na API de inscrição sem toque.

Um DeviceIdentifier combina metadados ou IDs de hardware necessários para identificar exclusivamente um dispositivo.

Sua organização inclui os valores do identificador do dispositivo ao fazer upload de dados do dispositivo pelo portal ou ao chamar a API.

Campos obrigatórios

dispositivos Android;

O registro sem toque normalmente identifica dispositivos pelos IDs de modem celular IMEI (ou MEID). Para oferecer suporte a dispositivos sem modems celulares, como tablets, você também pode identificar dispositivos usando um conjunto diferente de campos. A tabela a seguir mostra os campos que podem ser usados para cada tipo de dispositivo:

Identificador Rede celular Somente Wi-Fi Observações
hardware_id O campo precisa ser um número IMEI ou MEID. A inscrição sem contato valida o formato dos valores de IMEI quando você os transmite em argumentos de API.
hardware_id2 Esse campo precisa ser um segundo número de IMEI ou MEID. A inscrição sem contato valida o formato dos valores de IMEI quando você os transmite em argumentos de API. Para informações sobre dispositivos com mais de um modem celular, consulte Dispositivos dual chip.
serialNumber O número de série do fabricante do dispositivo. O número de série é diferencia maiúsculas de minúsculas e é o mesmo valor retornado por Build.getSerial().
model O valor do modelo do dispositivo precisa corresponder ao valor integrado do dispositivo retornado em Build.MODEL. Consulte a referência de nomes de modelos para conferir uma lista de valores permitidos para cada fabricante.
manufacturer O valor do campo manufacturer precisa corresponder ao valor integrado do dispositivo retornado de Build.MANUFACTURER. Consulte a referência nomes de fabricantes para mais informações.

Se você estiver registrando o número de série, também precisará registrar o fabricante e o modelo para garantir que o registro sem toque consiga detectar o dispositivo.

Dispositivos dual chip

Os dispositivos dual chip incluem dois modems separados e têm dois números IMEI. Se você estiver registrando apenas um IMEI, prefira o número IMEI mais baixo, já que o registro sem toque funciona de forma mais confiável com o IMEI mais baixo. Para aumentar a confiabilidade, você também pode registrar o outro IMEI ou o número de série, fabricante e modelo.

Para mostrar o segundo IMEI no portal do registro sem toque:

  1. Acesse a guia Dispositivos.
  2. No canto superior direito, ao lado do botão Add Device, clique nos três pontos .
  3. Selecione Personalizar tabela.
  4. Marque a caixa de seleção IMEI2.
  5. Clique em Salvar.

Dispositivos ChromeOS

Para dispositivos ChromeOS, o conjunto de identificadores necessários é o mesmo para dispositivos somente Wi-Fi e celulares:

Identificador Observações
serialNumber O número de série do fabricante do dispositivo.
model O valor do modelo do dispositivo precisa corresponder ao valor integrado do dispositivo. Consulte a lista de valores de modelo do ChromeOS para referência.
chromeOsAttestedDeviceId O ID do dispositivo atestado. Consulte a lista de dispositivos ChromeOS compatíveis para referência.

Fazer referência a um dispositivo

Use um DeviceIdentifier ao encontrar ou reivindicar dispositivos. É necessário incluir os campos obrigatórios especificados para o tipo de dispositivo.

O snippet a seguir mostra um número IMEI usado para pesquisar um dispositivo específico chamando 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()

O snippet a seguir mostra como criar um identificador de dispositivo com um número de série:

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

Saiba mais