ID

DeviceIdentifier 會封裝硬體 ID，用於識別製造裝置。本文說明如何在零接觸註冊 API 中使用 ID。

DeviceIdentifier 會結合硬體中繼資料或 ID，用於識別裝置。

貴機構透過入口網站上傳裝置資料或呼叫 API 時，會納入裝置 ID 值。

必填欄位

Android 裝置

零接觸註冊機制通常會根據 IMEI (或 MEID) 行動數據機 ID 識別裝置。如要支援沒有行動數據機的裝置 (例如平板電腦)，您也可以使用不同的欄位組合來識別裝置。下表列出可用於各類型裝置的欄位：

ID 行動網路 僅限 Wi-Fi 附註
hardware_id 這個欄位必須是 IMEI 或 MEID 號碼。當您在 API 引數中傳遞 IMEI 值時，Zero-touch 註冊程序會驗證 IMEI 值的格式。
hardware_id2 這個欄位必須是第二個 IMEI 或 MEID 號碼。當您在 API 引數中傳遞 IMEI 值時，Zero-touch 註冊會驗證 IMEI 值的格式。如要瞭解裝置中有多個行動數據機的情況，請參閱「雙 SIM 卡裝置」。
serialNumber 裝置製造商的序號。序號會區分大小寫，且與 Build.getSerial() 傳回的值相同。
model 裝置型號值必須與 Build.MODEL 傳回的裝置內建值相符。如要瞭解各製造商允許的值清單，請參閱型號名稱參考資料。
manufacturer manufacturer 欄位值必須與 Build.MANUFACTURER 傳回的裝置內建值相符。詳情請參閱製造商名稱參考資料。

如果要註冊序號，您也必須註冊製造商和型號，以確保零接觸註冊機制能夠偵測到裝置。

雙 SIM 卡裝置

雙 SIM 卡裝置搭載兩個獨立數據機，且具備兩個 IMEI 號碼。如果只註冊一個 IMEI 號碼，請優先使用數值最低的 IMEI 號碼，因為零接觸註冊機制會以較可靠的方式使用數值最低的 IMEI 號碼。為提高可靠性，您可以另外註冊其他 IMEI 或序號、製造商和型號。

如要在零接觸入口網站中顯示第二組 IMEI，請按照下列步驟操作：

  1. 前往「裝置」分頁。
  2. 按一下右上角「新增裝置」按鈕旁的三點圖示 。
  3. 選取「自訂表格」。
  4. 勾選「IMEI2」IMEI2核取方塊。
  5. 按一下 [儲存]。

ChromeOS 裝置

對於 ChromeOS 裝置，無論是行動網路裝置還是僅限 Wi-Fi 裝置，所需的 ID 都相同：

ID 附註
serialNumber 裝置製造商的序號。
model 裝置型號值必須與裝置內建值相符。請參閱 ChromeOS 型號值清單。
chromeOsAttestedDeviceId 已驗證的裝置 ID。請參閱相容的 ChromeOS 裝置清單。

參照裝置

尋找或聲明裝置時，請使用 DeviceIdentifier。您必須加入裝置類型指定的必要欄位。

下列程式碼片段顯示 IMEI 號碼，可透過呼叫 partners.devices.findByIdentifier 搜尋特定裝置：

Java.NETPython
// 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()

以下程式碼片段說明如何使用序號建立裝置 ID：

Java.NETPython
// 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'}

瞭解詳情