識別子

DeviceIdentifier は、製造されたデバイスを識別するためにハードウェア ID をカプセル化します。このドキュメントでは、ゼロタッチ登録 API で ID を操作する方法について説明します。

DeviceIdentifier は、デバイスを一意に識別するために必要なハードウェア メタデータまたは ID を組み合わせたものです。

組織は、ポータルからデバイスデータをアップロードするか、API を呼び出すときにデバイス ID 値を含めます。

必須項目

Android デバイス

通常、ゼロタッチ登録では、IMEI（または MEID）モバイル モデム ID でデバイスを識別します。タブレットなど、モバイル モデムのないデバイスをサポートするには、別のフィールドセットを使用してデバイスを識別することもできます。次の表に、各デバイス タイプで使用できるフィールドを示します。

識別子 モバイル Wi-Fi のみ メモ
hardware_id このフィールドには IMEI または MEID 番号を入力する必要があります。Zero-touch enrollment は、IMEI 値を API 引数で渡すときに、IMEI 値の形式を検証します。
hardware_id2 このフィールドには、2 つ目の IMEI または MEID 番号を入力する必要があります。Zero-touch enrollment は、IMEI 値を API 引数で渡すときに、IMEI 値の形式を検証します。複数のモバイル モデムを搭載したデバイスについては、デュアル SIM デバイスをご覧ください。
serialNumber デバイスのメーカーのシリアル番号。シリアル番号は大文字と小文字が区別され、Build.getSerial() から返される値と同じです。
model デバイスモデルの値は、Build.MODEL から返されたデバイスの組み込み値と一致している必要があります。各メーカーで使用できる値の一覧については、モデル名のリファレンスをご覧ください。
manufacturer manufacturer フィールドの値は、Build.MANUFACTURER から返されたデバイスの組み込み値と一致する必要があります。詳しくは、メーカー名のリファレンスをご覧ください。

シリアル番号を登録する場合は、ゼロタッチでデバイスを検出できるように、メーカーとモデルも登録する必要があります。

デュアル SIM デバイス

デュアル SIM デバイスには 2 つの個別のモデムが搭載されており、それぞれに IMEI 番号があります。1 つの IMEI のみを登録する場合は、ゼロタッチ登録が最も小さい IMEI でより確実に機能するため、数字が小さい方の IMEI 番号を優先します。信頼性を高めるために、他の IMEI またはシリアル番号、メーカー、モデルを追加で登録できます。

ゼロタッチ ポータルで 2 つ目の IMEI を表示するには:

  1. [デバイス] タブに移動します。
  2. 右上の [デバイスを追加] ボタンの横にあるその他アイコン をクリックします。
  3. [テーブルをカスタマイズ] を選択します。
  4. [IMEI2] のチェックボックスをオンにします。
  5. [保存] をクリックします。

ChromeOS デバイス

ChromeOS デバイスの場合、必要な識別子のセットは、モバイルと Wi-Fi のみのデバイスで同じです。

識別子 メモ
serialNumber デバイスのメーカーのシリアル番号。
model デバイスモデルの値は、デバイスの組み込み値と一致している必要があります。参考として、ChromeOS モデル値のリストをご覧ください。
chromeOsAttestedDeviceId 対応の有無がわかるデバイス ID。詳しくは、対応する ChromeOS デバイスのリストをご覧ください。

デバイスを参照する

デバイスの検索または申し込みを行う場合は DeviceIdentifier を使用します。デバイスの種類に指定されている必須フィールドを含める必要があります。

次のスニペットは、partners.devices.findByIdentifier を呼び出して特定のデバイスを検索するために使用される IMEI 番号を示しています。

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

次のスニペットは、シリアル番号を含むデバイス ID を作成する方法を示しています。

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

その他の情報