REST Resource: customers.devices

资源:设备

一台已注册零触摸注册的 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

仅供输出。采用 customers/[CUSTOMER_ID]/devices/[DEVICE_ID] 格式的 API 资源名称。由服务器分配。

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) 提供的标识符,在制作和销售过程中使用。仅适用于 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 操作系统设备的 Google Workspace 帐号的 ID。

additionalService

enum (AdditionalService)

为设备注册的附加服务。

DeviceProvisioningSectionType

预配记录的区段类型。

枚举
SECTION_TYPE_SIM_LOCK SIM 卡锁定部分类型。
SECTION_TYPE_ZERO_TOUCH 零触摸注册部分类型。

附加服务

为设备注册的附加服务。

枚举
DEVICE_PROTECTION 设备保护服务,也称为 Android Enterprise Essentials。若要使用设备保护服务声明设备,您必须向合作伙伴团队进行注册。

方法

applyConfiguration

将配置应用于设备,以注册设备以进行零触摸注册。

get

获取设备的详细信息。

list

列出客户的设备。

removeConfiguration

从设备中移除配置。

unclaim

向客户取消认领设备,并将其从零触摸注册中移除。