Identifiants

Un DeviceIdentifier encapsule les ID matériels pour identifier un appareil fabriqué. Ce document explique comment utiliser les identifiants dans l'API d'enregistrement sans contact.

Un DeviceIdentifier combine les métadonnées ou les ID matériels requis pour identifier de manière unique un appareil.

Votre organisation inclut les valeurs d'identifiant de l'appareil lors de l'importation des données de l'appareil via le portail ou de l'appel de l'API.

Champs obligatoires

Appareils Android

L'enregistrement sans contact identifie généralement les appareils à l'aide des identifiants de modem mobile IMEI (ou MEID). Pour prendre en charge les appareils sans modems cellulaires, tels que les tablettes, vous pouvez également identifier les appareils à l'aide d'un autre ensemble de champs. Le tableau suivant indique les champs que vous pouvez utiliser pour chaque type d'appareil:

Identifiant Connexion cellulaire Wi-Fi uniquement Remarques
hardware_id Ce champ doit être un numéro IMEI ou MEID. L'enregistrement sans contact valide le format des valeurs IMEI lorsque vous les transmettez dans des arguments d'API.
hardware_id2 Ce champ doit contenir un deuxième numéro IMEI ou MEID. L'enregistrement sans contact valide le format des valeurs IMEI lorsque vous les transmettez dans des arguments d'API. Pour en savoir plus sur les appareils équipés de plusieurs modems mobiles, consultez la section Appareils à double carte SIM.
serialNumber Numéro de série du fabricant de l'appareil. Le numéro de série est sensible à la casse et correspond à la même valeur renvoyée par Build.getSerial().
model La valeur du modèle de l'appareil doit correspondre à la valeur intégrée de l'appareil renvoyée par Build.MODEL. Consultez la référence sur les noms de modèles pour obtenir la liste des valeurs autorisées pour chaque fabricant.
manufacturer La valeur du champ manufacturer doit correspondre à la valeur intégrée de l'appareil renvoyée par Build.MANUFACTURER. Pour en savoir plus, consultez la documentation de référence sur les noms des fabricants.

Si vous enregistrez un numéro de série, vous devez également enregistrer le fabricant et le modèle pour vous assurer que l'enregistrement sans contact peut détecter l'appareil.

Appareils avec double carte SIM

Un appareil avec double carte SIM dispose de deux modems distincts et possède deux codes IMEI. Si vous n'enregistrez qu'un seul IMEI, privilégiez le code IMEI le plus bas, car l'enregistrement sans contact fonctionne plus efficacement avec le code IMEI le plus bas. Pour améliorer la fiabilité, vous pouvez également enregistrer l'autre code IMEI, ou le numéro de série, le fabricant et le modèle.

Pour afficher le deuxième IMEI dans le portail sans contact:

  1. Accédez à l'onglet Appareils.
  2. En haut à droite, à côté du bouton Ajouter un appareil, cliquez sur les trois points .
  3. Sélectionnez Personnaliser le tableau.
  4. Cochez la case IMEI2.
  5. Cliquez sur Enregistrer.

Appareils ChromeOS

Pour les appareils ChromeOS, l'ensemble des identifiants requis est le même pour les appareils mobiles et les appareils Wi-Fi uniquement:

Identifiant Remarques
serialNumber Numéro de série du fabricant de l'appareil.
model La valeur du modèle de l'appareil doit correspondre à la valeur intégrée de l'appareil. Pour référence, consultez la liste des valeurs de modèle ChromeOS.
chromeOsAttestedDeviceId ID de l'appareil certifié. Pour référence, consultez la liste des appareils ChromeOS compatibles.

Faire référence à un appareil

Utilisez un DeviceIdentifier pour rechercher ou revendiquer des appareils. Vous devez inclure les champs obligatoires spécifiés pour le type d'appareil.

L'extrait de code suivant montre un code IMEI utilisé pour rechercher un appareil spécifique en appelant 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()

L'extrait de code suivant montre comment créer un identifiant d'appareil avec un numéro 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'}

En savoir plus