REST Resource: customers.devices

資源：Device

註冊零接觸註冊機制的 Android 或 Chrome OS 裝置。

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，以識別製造商的裝置。如要瞭解識別碼集的相關規定，請參閱識別碼一節。

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 作業系統中。
deviceType

enum (DeviceType)

裝置類型
chromeOsAttestedDeviceId

string

原始設備製造商 (OEM) 提供的 ID，需透過生產與銷售流程。僅適用於 Chrome 作業系統裝置。
聯集欄位 hardware_id。根據數據機 ID 設計的硬體 ID。hardware_id 只能是下列其中一項：
imei

string

裝置的 IMEI 號碼。輸入時已通過驗證。
meid

string

裝置的 MEID 號碼。

DeviceType

裝置搭載的作業系統。

列舉
DEVICE_TYPE_ANDROID Android 裝置
DEVICE_TYPE_CHROME_OS Chrome 作業系統裝置

裝置中繼資料

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

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

map (key: string, value: string)

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

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

裝置憑證附加資訊

經銷商為客戶索取的裝置記錄。適用於零接觸註冊機制的裝置會聲明類型為 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

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

enum (AdditionalService)

為裝置註冊的額外服務。

裝置佈建版面類型

佈建記錄的區段類型。

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

額外服務

為裝置註冊的額外服務。

列舉
DEVICE_PROTECTION 裝置保護服務，也稱為 Android Enterprise 基本功能。如要申請使用裝置保護服務，請向合作夥伴小組註冊。

方法

applyConfiguration

 對裝置套用「設定」，為裝置註冊零接觸註冊機制。

get

 取得裝置詳細資訊。

list

 列出客戶的裝置。

removeConfiguration

 從裝置移除設定。

unclaim

 取消客戶裝置的擁有權，並將裝置從零接觸註冊機制中移除。