REST Resource: customers.devices

資源：裝置

已註冊零接觸註冊機制的 Android 或 ChromeOS 裝置。

JSON 表示法 
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
欄位
deviceId

string (int64 format)

僅供輸出。裝置的 ID。由伺服器指派。
deviceIdentifier

object (DeviceIdentifier)

用於識別製造裝置的硬體 ID。詳情請參閱「ID」。
name

string

僅供輸出。API 資源名稱，格式為 customers/[CUSTOMER_ID]/devices/[DEVICE_ID]。由伺服器指派。
deviceMetadata

object (DeviceMetadata)

附加至裝置的中繼資料。結構為鍵/值組合。
claims[]

object (DeviceClaim)

僅供輸出。裝置佈建憑證附加資訊。已申請零接觸註冊機制的裝置含有類型為「SECTION_TYPE_ZERO_TOUCH」的著作權聲明。呼叫 customers.devices.unclaim，將裝置從零接觸註冊機制中移除。
configuration

string

要套用至裝置的設定，格式為 customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]。如果裝置未套用任何設定，這個值會是 null。

裝置識別碼

封裝硬體和產品 ID，以便識別製造裝置。如要瞭解 ID 集的相關規定，請參閱「ID」一文。

JSON 表示法 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.
}
欄位
serialNumber

string

裝置的製造商序號。這個值在各種裝置型號上可能重複。
manufacturer

string

裝置製造商的名稱。比對裝置透過 android.os.Build.MANUFACTURER 傳回的內建值。如需支援的值，請參閱 Android 製造商。
model

string

裝置型號的名稱。允許的值會列在 Android 型號和 Chrome OS 型號中。
deviceType

enum (DeviceType)

裝置類型
chromeOsAttestedDeviceId

string

由原始設備製造商 (OEM) 提供的 ID，由生產和銷售程序中執行。僅適用於 ChromeOS 裝置。
聯集欄位 hardware_id。硬體 ID (根據數據機 ID)。hardware_id 只能是下列其中一項：
imei

string

裝置的 IMEI 號碼。輸入內容驗證成功。
meid

string

裝置的 MEID 號碼。

DeviceType

裝置搭載的作業系統。

列舉
DEVICE_TYPE_ANDROID Android 裝置
DEVICE_TYPE_CHROME_OS ChromeOS 裝置

DeviceMetadata

可附加至 Device 的中繼資料項目。詳情請參閱「裝置中繼資料」。

JSON 表示法 
{
  "entries": {
    string: string,
    ...
  }
}
欄位
entries

map (key: string, value: string)

記錄為鍵/值組合的中繼資料項目。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

DeviceClaim

經銷商為客戶申請的裝置記錄。已申請零接觸註冊機制的裝置含有類型為「SECTION_TYPE_ZERO_TOUCH」的著作權聲明。詳情請參閱「為客戶認領裝置」。

JSON 表示法 
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
欄位
sectionType

enum (DeviceProvisioningSectionType)

僅供輸出。對裝置提出的版權聲明類型。
ownerCompanyId

string (int64 format)

購買 Android 裝置的客戶 ID。
googleWorkspaceCustomerId

string

擁有 ChromeOS 裝置的 Google Workspace 帳戶 ID。
additionalService

enum (AdditionalService)

為裝置註冊的額外服務。

DeviceProvisioningSectionType

佈建記錄的部分類型。

列舉
SECTION_TYPE_SIM_LOCK SIM 卡鎖定區塊類型。
SECTION_TYPE_ZERO_TOUCH 零接觸註冊機制部分類型。

AdditionalService

已為裝置註冊額外服務。

列舉
DEVICE_PROTECTION 裝置額外保固方案，也稱為 Android Enterprise 基本功能。如要領取裝置額外保固方案的裝置，您必須向合作夥伴團隊註冊。

方法

applyConfiguration

 將設定套用至裝置，為裝置註冊零接觸註冊機制。

get

 取得裝置的詳細資料。

list

 列出客戶的裝置。

removeConfiguration

 從裝置上移除設定。

unclaim

 從客戶取消認領裝置，並從零接觸註冊機制中移除裝置。