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.

  // 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。適用於雙 SIM 卡裝置的第二組硬體 ID。如果已設定,則必須與第一個硬體 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,
  "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

更新連結至一批裝置的轉售商中繼資料。