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

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