識別子

DeviceIdentifier は、ハードウェア ID をカプセル化して、サービスを識別します。 製造されたデバイスです。このドキュメントでは、 ゼロタッチ登録 API を使用できます。

DeviceIdentifier は、一意に必要なハードウェア メタデータまたは ID を組み合わせて、 識別します

デバイスのアップロード時に、組織によってデバイス ID の値が含められます または API の呼び出しを通じて データをクエリできますDeviceIdentifier 個のインスタンス API を使用してフィールド値を変更することはできません。

必須項目

Android デバイス

ゼロタッチ登録では、通常、IMEI（または MEID）でデバイスを識別します。 セルラーモデム ID。ただし、 異なるフィールド セットを使用してデバイスを識別することもできます。「 次の表に、デバイスの種類ごとに必要なフィールドを示します。

識別子 モバイル Wi-Fi のみ メモ
hardware_id この項目には IMEI 番号または MEID 番号を入力してください。ゼロタッチ登録では、API 引数で IMEI 値を渡すときに、IMEI 値の形式を検証します。複数のモバイルモデムを備えたデバイスの場合は、デュアル SIM デバイスを参照してください。
serialNumber デバイスのメーカーのシリアル番号。シリアル番号では大文字と小文字が区別され、Build.getSerial() から返されるものと同じ値です。
model デバイスモデルの値は、Build.MODEL から返されたデバイスの組み込み値と一致している必要があります。各メーカーで使用できる値の一覧については、モデル名のリファレンスをご覧ください。
manufacturer Wi-Fi 専用デバイスでゼロタッチ登録を機能させるには、manufacturer フィールドの値が Build.MANUFACTURER から返されたデバイスの組み込み値と一致している必要があります。モバイル デバイスの場合、manufacturer フィールドは省略可能ですが、ユーザーがデバイスを識別しやすくなるため、指定することをおすすめします。詳細については、メーカー名のリファレンスをご覧ください。

デバイスにセルラーモデムが含まれていない場合（タブレット、 [Wi-Fi only] フィールドを使用します。その他のすべてのデバイスでは セルラー フィールドを使用します。

デュアル SIM デバイス

デュアル SIM デバイスには 2 つの個別のモデムが搭載されており、それぞれに IMEI 番号があります。こちらの 数字が小さい方の IMEI 番号（ゼロタッチ登録の効果が高いため） 保証します。

ChromeOS デバイス

ChromeOS デバイスの場合、必須の ID のセットはモバイル デバイスの場合も同じ Wi-Fi 専用デバイスの場合:

識別子 メモ
serialNumber デバイスのメーカーのシリアル番号 ダウンロードします
model デバイスモデルの値は、デバイスの 使用できます。ChromeOS モデルの値の一覧をご覧ください。 ご覧ください。
chromeOsAttestedDeviceId 証明済みのデバイス ID。 対応する ChromeOS デバイスを ご覧ください。

デバイスを紹介する

デバイスの検索または申請には DeviceIdentifier を使用します。次を含める必要があります デバイスタイプに指定された必須フィールド。

次のスニペットは、特定のデバイスの検索に使用される IMEI 番号を示しています。 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()

以下のスニペットは、Wi-Fi 専用デバイスを作成する方法を示しています。 識別子:

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

その他の情報