REST Resource: customers.devices

资源：设备

已注册零触摸注册的 Android 或 ChromeOS 设备。

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.

  // 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) 提供的标识符，贯穿整个生产和销售流程。仅适用于 ChromeOS 设备。
联合字段 hardware_id。基于调制解调器 ID 的硬件 ID。hardware_id 只能是下列其中一项：
imei

string

设备的 IMEI 码。在输入时进行验证。
meid

string

设备的 MEID 号。
联合字段 hardware_id2。第二个硬件 ID，适用于双 SIM 卡设备。如果设置，则必须与第一个硬件 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,
  "additionalService": enum (AdditionalService)
}
字段
sectionType

enum (DeviceProvisioningSectionType)

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

string (int64 format)

购买设备的客户的 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

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