REST Resource: customers.devices

资源:Device

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

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。如需了解详情,请参阅标识符

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

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,
  "additionalService": enum (AdditionalService)
}
字段
sectionType

enum (DeviceProvisioningSectionType)

仅限输出。设备上提出的版权主张类型。

ownerCompanyId

string (int64 format)

购买 Android 设备的客户 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 Essentials。如要通过设备保护服务领取设备,您必须向合作伙伴团队注册。

方法

applyConfiguration

对设备应用配置,以便为设备注册零触摸注册。

get

获取设备的详细信息。

list

列出客户的设备。

removeConfiguration

从设备中移除配置。

unclaim

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