Kennungen

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

Ein DeviceIdentifier kombiniert Hardwaremetadaten oder IDs, die zur eindeutigen Identifizierung eines Geräts erforderlich sind.

Ihre Organisation fügt die Gerätekennungswerte beim Hochladen von Gerätedaten über das Portal oder beim Aufrufen der API hinzu. Da 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-Mobilfunkmodem-IDs identifiziert. Zur Unterstützung von Geräten ohne Mobilfunkmodem, z. B. Tablets, können Sie Geräte jedoch auch mithilfe anderer Felder identifizieren. Die folgende Tabelle zeigt die für jeden Gerätetyp erforderlichen Felder:

Kennung Mobilfunk Nur WLAN Hinweise
hardware_id Dieses Feld muss eine IMEI- oder MEID-Nummer enthalten. Bei der Zero-Touch-Registrierung wird das Format der IMEI-Werte 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 Geräts. Bei der Seriennummer muss die Groß-/Kleinschreibung beachtet werden. Sie ist der gleiche Wert, 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 die einzelnen Hersteller.
manufacturer Damit die Zero-Touch-Registrierung bei einem reinen WLAN-Gerät funktioniert, muss der Feldwert manufacturer mit dem integrierten Wert des Geräts übereinstimmen, der von Build.MANUFACTURER zurückgegeben wird. Bei Mobilfunkgeräten ist das Feld „manufacturer“ optional, wird aber empfohlen, da es Kunden so leichter macht, ihre Geräte zu identifizieren. Weitere Informationen finden Sie in der Referenz zu Herstellernamen.

Wenn das Gerät kein Mobilfunkmodem hat, z. B. ein Tablet oder einen Lagerinventarscanner, verwenden Sie die Felder „Nur WLAN“. Verwenden Sie für alle anderen Geräte die Mobilfunkfelder.

Dual-SIM-Geräte

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

ChromeOS-Geräte

Bei ChromeOS-Geräten sind die erforderlichen Kennungen für Mobilfunk- und WLAN-Geräte identisch:

Kennung Hinweise
serialNumber Die Seriennummer des Geräts.
model Der Wert des Gerätemodells muss mit dem integrierten Wert des Geräts übereinstimmen. Weitere Informationen finden Sie in der Liste der ChromeOS-Modellwerte.
chromeOsAttestedDeviceId Die attestierte Geräte-ID. Eine Liste der kompatiblen ChromeOS-Geräte finden Sie in der Liste der kompatiblen ChromeOS-Geräte.

Auf ein Gerät verweisen

Verwende DeviceIdentifier, wenn du Geräte suchst oder beanspruchst. Sie müssen alle für den Gerätetyp angegebenen Pflichtfelder ausfüllen.

Das folgende Snippet zeigt eine IMEI-Nummer, mit der nach einem bestimmten Gerät gesucht werden kann, indem partners.devices.findByIdentifier aufgerufen wird:

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 eine reine WLAN-Geräte-ID erstellt wird:

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