Kennungen

Eine DeviceIdentifier kapselt Hardware-IDs ein, um ein hergestelltes Gerät zu identifizieren. In diesem Dokument wird beschrieben, wie Sie mit IDs in der Zero-Touch-Registrierungs-API arbeiten.

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

Ihre Organisation gibt die Werte der Geräte-ID an, wenn sie Gerätedaten über das Portal hochlädt oder die API aufruft.

Pflichtfelder

Android-Geräte

Bei der Zero-Touch-Registrierung werden Geräte in der Regel anhand der IMEI (oder MEID) des Mobilfunkmodems identifiziert. Wenn Sie Geräte ohne Mobilfunkmodems wie Tablets unterstützen möchten, können Sie Geräte auch mit anderen Feldern identifizieren. In der folgenden Tabelle sind die Felder aufgeführt, die Sie für jeden Gerätetyp verwenden können:

Wenn Sie die Seriennummer registrieren, müssen Sie auch den Hersteller und das Modell registrieren, damit das Gerät über Zero-Touch erkannt werden kann.

Dual-SIM-Geräte

Ein Gerät mit zwei SIM-Karten hat zwei Modems und zwei IMEI-Nummern. Wenn Sie nur eine IMEI registrieren, verwenden Sie die numerisch niedrigste IMEI-Nummer, da die Zero-Touch-Registrierung mit der niedrigsten IMEI zuverlässiger funktioniert. Um die Zuverlässigkeit zu erhöhen, können Sie zusätzlich die andere IMEI oder die Seriennummer, den Hersteller und das Modell registrieren.

So rufen Sie die zweite IMEI im Zero-Touch-Portal auf:

1. Rufen Sie den Tab Geräte auf.
2. Klicken Sie rechts oben neben der Schaltfläche Gerät hinzufügen auf das Dreipunkt-Menü more_vert.
3. Wählen Sie Tabelle anpassen aus.
4. Klicken Sie auf das Kästchen für IMEI2.
5. Klicken Sie auf Speichern.

ChromeOS-Geräte

Für ChromeOS-Geräte sind die erforderlichen IDs für Geräte mit Mobilfunkverbindung und nur WLAN identisch:

Auf ein Gerät verweisen

Verwenden Sie ein DeviceIdentifier, wenn Sie Geräte finden oder beanspruchen. Sie müssen die für den Gerätetyp erforderlichen Felder angeben.

Im folgenden Snippet wird eine IMEI-Nummer verwendet, um über partners.devices.findByIdentifier nach einem bestimmten Gerät zu suchen:

// 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();

// 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();

# 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 Geräte-ID mit einer Seriennummer erstellt wird:

// Create a device identifier to find a Wi-Fi-only device.
DeviceIdentifier deviceIdentifier = new DeviceIdentifier();
deviceIdentifier.setManufacturer("Honeywell");
deviceIdentifier.setModel("VM1A");
deviceIdentifier.setSerialNumber("ABcd1235678");

// Create a device identifier to find a Wi-Fi-only device.
var deviceIdentifier = new DeviceIdentifier
{
    Manufacturer = "Honeywell",
    Model = "VM1A",
    SerialNumber = "ABcd1235678"
};

# 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 findest du in der API-Referenzdokumentation für DeviceIdentifier.
• Eine Liste der zulässigen Herstellernamen und Gerätemodelle finden Sie in der Referenz zu Herstellernamen.
• Eine Liste der kompatiblen ChromeOS-Geräte finden Sie in der ChromeOS-Hilfe.