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:

ID 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.
hardware_id2 Dieses Feld muss eine zweite 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 mehreren Mobilfunkmodemen finden Sie unter Dual-SIM-Geräte.
serialNumber Die Seriennummer des Herstellers für das Gerät. Bei der Seriennummer wird zwischen Groß- und Kleinschreibung unterschieden. Sie entspricht dem Wert, der von Build.getSerial() zurückgegeben wird.
model Der Wert für das Gerätemodell muss mit dem vordefinierten Wert des Geräts übereinstimmen, der von Build.MODEL zurückgegeben wird. Eine Liste der zulässigen Werte für jeden Hersteller finden Sie in der Referenz Modellnamen.
manufacturer Der Feldwert manufacturer muss mit dem integrierten Wert des Geräts übereinstimmen, der von Build.MANUFACTURER zurückgegeben wird. Weitere Informationen finden Sie in der Referenz Herstellernamen.

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ü .
  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:

ID Hinweise
serialNumber Die Seriennummer des Herstellers für das Gerät.
model Der Wert für das Gerätemodell muss mit dem vordefinierten Wert des Geräts übereinstimmen. Eine Liste der ChromeOS-Modellwerte finden Sie in diesem Hilfeartikel.
chromeOsAttestedDeviceId Die attestierte Geräte-ID. Eine Liste der kompatiblen ChromeOS-Geräte finden Sie hier.

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:

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 Geräte-ID mit einer Seriennummer 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