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

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