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.

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

string

裝置製造商的序號。這個值在不同裝置型號之間可能不具唯一性。
manufacturer

string

裝置製造商的名稱。比對裝置透過 android.os.Build.MANUFACTURER 傳回的內建值。Android 製造商列出可用的值。
model

string

裝置型號的名稱。如要查看允許的值，請參閱「Android 型號」和「ChromeOS 型號」。
deviceType

enum (DeviceType)

裝置類型
chromeOsAttestedDeviceId

string

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

string

裝置的 IMEI 號碼。在輸入時驗證。
meid

string

裝置的 MEID 號碼。
聯集欄位 hardware_id2。第二個硬體 ID，適用於雙 SIM 卡裝置。如果已設定，則必須與第一個硬體 ID 使用相同的 ID 類型。hardware_id2 只能是下列其中一項：
imei2

string

裝置的第二組 IMEI 號碼。
meid2

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)

購買裝置的客戶 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

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