IDs

Ein DeviceIdentifier kapselt Hardware-IDs zur Identifizierung eines hergestellten Gerätes. In diesem Dokument wird erläutert, wie Sie IDs in der API für die Zero-Touch-Registrierung.

Ein DeviceIdentifier kombiniert Hardwaremetadaten oder IDs, die für die eindeutige um ein Gerät zu identifizieren.

Ihre Organisation gibt beim Hochladen des Geräts die Werte der Gerätekennung an über das Portal oder durch Aufrufen der API. Weil DeviceIdentifier Instanzen unveränderlich sind, können Sie die Feldwerte nicht über die API ändern.

Pflichtfelder

Android-Geräte

Bei der Zero-Touch-Registrierung werden Geräte in der Regel anhand der IMEI (oder MEID) identifiziert. Mobilfunk-Modem-IDs. Zur Unterstützung von Geräten ohne Mobilfunkmodem, z. B. können Sie Geräte auch über andere Felder identifizieren. Die In der folgenden Tabelle sind die Felder aufgeführt, die für jeden Gerätetyp erforderlich sind:

Kennung Mobilfunk Nur WLAN Hinweise
hardware_id Dieses Feld muss eine IMEI- oder MEID-Nummer enthalten. Bei der Zero-Touch-Registrierung wird das Format von IMEI-Werten validiert, wenn Sie sie in API-Argumenten übergeben. Informationen zu Geräten mit mehr als einem Mobilfunkmodem finden Sie unter Geräte mit zwei SIM-Karten.
serialNumber Die Seriennummer des Herstellers. Bei der Seriennummer wird zwischen Groß- und Kleinschreibung unterschieden. Sie ist mit dem Wert identisch, der von Build.getSerial() zurückgegeben wird.
model Der Wert des Gerätemodells muss mit dem integrierten Wert des Geräts übereinstimmen, der von Build.MODEL zurückgegeben wird. In der Referenz zu Modellnamen finden Sie eine Liste der zulässigen Werte für jeden Hersteller.
manufacturer Damit die Zero-Touch-Registrierung auf einem reinen WLAN-Gerät funktioniert, muss der Wert im Feld manufacturer mit dem integrierten Wert des Geräts übereinstimmen, der von Build.MANUFACTURER zurückgegeben wird. Bei Mobilgeräten ist das Feld manufacturer optional, wird aber empfohlen, da Kunden ihre Geräte so leichter erkennen können. Weitere Informationen finden Sie in der Referenz zu den Herstellernamen.

Wenn das Gerät kein Mobilfunkmodem hat, z. B. ein Tablet oder Lagerbestandsscanner verwenden möchten, verwenden Sie die Felder "Nur WLAN". Bei allen anderen Geräten die mobilen Felder verwenden.

Dual-SIM-Geräte

Ein Gerät mit zwei SIM-Karten hat zwei Modems und zwei IMEI-Nummern. Verwenden Sie die Methode numerisch niedrigste IMEI-Nummer, da die Zero-Touch-Registrierung eher funktioniert zuverlässig mit der niedrigsten IMEI.

ChromeOS-Geräte

Für ChromeOS-Geräte sind für Mobilfunkgeräte dieselben erforderlichen IDs erforderlich. und reine WLAN-Geräte:

Kennung Hinweise
serialNumber Die Seriennummer des Herstellers .
model Der Wert des Gerätemodells muss mit dem des Geräts übereinstimmen integrierten Mehrwert bieten. Liste der ChromeOS-Modellwerte als Referenz.
chromeOsAttestedDeviceId Die attestierte Geräte-ID. Hier finden Sie eine Liste der kompatibles ChromeOS Geräte für Referenz.

Gerät verweisen

Verwende DeviceIdentifier, um Geräte zu finden oder zu beanspruchen. Sie müssen die für den Gerätetyp angegebenen Pflichtfelder.

Das folgende Snippet zeigt eine IMEI-Nummer, mit der nach einem bestimmten Gerät gesucht wird durch Aufrufen von 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()

Das folgende Snippet zeigt, wie du ein reines WLAN-Gerät erstellst. Kennung:

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

Weitere Informationen

  • Weitere Informationen zu Hardware-IDs finden Sie in der API-Referenzdokumentation für DeviceIdentifier
  • Eine Liste der zulässigen Herstellernamen und Gerätemodelle findest du in der Herstellernamen.
  • Eine Liste kompatibler ChromeOS-Geräte findest du in der ChromeOS-Hilfe