REST Resource: partners.devices

资源：设备

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

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.unclaim 或 partners.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.

  // 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,
  "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

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