REST Resource: partners.devices

资源:Device

一台已注册零触摸注册的 Android 或 Chrome 操作系统设备。

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

string (int64 format)

仅限输出。设备的 ID。由服务器分配。

deviceIdentifier

object (DeviceIdentifier)

用于标识制造完成的设备的硬件 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 以标识制造的设备。如需了解对标识符集的要求,请参阅标识符

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 型号ChromeOS 型号中列出了允许的值。

deviceType

enum (DeviceType)

设备的类型

chromeOsAttestedDeviceId

string

由 OEM 提供的标识符,用于在整个生产和销售流程中。此问题仅适用于 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 Essentials。如要通过设备保护服务领取设备,您必须向合作伙伴团队注册。

方法

claim

为客户认领设备并将其添加到零触摸注册。

claimAsync

异步声明客户的一批设备。

findByIdentifier

按硬件标识符(如 IMEI)查找设备。

findByOwner

查找已为客户领取的设备。

get

获取设备。

metadata

更新与设备关联的转销商元数据。

unclaim

取消对客户设备的声明,并将其从零触摸注册中移除。

unclaimAsync

异步为客户取消认领一批设备。

updateMetadataAsync

更新附加到批量设备的转销商元数据。