REST Resource: partners.devices

資源:裝置

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

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

string (int64 format)

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

deviceIdentifier

object (DeviceIdentifier)

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

name

string

僅供輸出。API 資源名稱,格式為 partners/[PARTNER_ID]/devices/[DEVICE_ID]。由伺服器指派。

deviceMetadata

object (DeviceMetadata)

附加至裝置的中繼資料。結構為鍵/值組合。詳情請參閱「裝置中繼資料」。

claims[]

object (DeviceClaim)

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

裝置識別碼

封裝硬體和產品 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,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
欄位
sectionType

enum (DeviceProvisioningSectionType)

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

ownerCompanyId

string (int64 format)

購買裝置的客戶 ID。

googleWorkspaceCustomerId

string

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

resellerId

string (int64 format)

領取裝置的經銷商 ID。

additionalService

enum (AdditionalService)

為裝置註冊的額外服務。

DeviceProvisioningSectionType

佈建記錄的部分類型。

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

AdditionalService

已為裝置註冊額外服務。

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

方法

claim

為客戶認領裝置並新增至零接觸註冊機制。

claimAsync

以非同步方式為客戶認領整批裝置。

findByIdentifier

依據硬體 ID (例如 IMEI) 尋找裝置。

findByOwner

尋找為客戶認領的裝置。

get

取得裝置。

metadata

更新與裝置相關聯的經銷商中繼資料。

unclaim

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

unclaimAsync

以非同步的方式為客戶取消一批裝置擁有權。

updateMetadataAsync

更新一批裝置中附加的經銷商中繼資料。