对象

公司参考资料

为公司唯一标识。

字段名称 数据类型 说明
companyId string 仅供输出。公司的 ID,由服务器分配。
vendor enum SamsungGoogle

公司

表示公司。

字段名称 数据类型 说明
companyReference object(CompanyReference) 公司参考对象。
companyName string 公司的名称。例如:XYZ Corp。在零触摸注册门户中向公司的员工显示。
vendorParams map 供应商指定的键值对中的额外字段。

设备

一台已注册注册的 Android 设备。

字段名称 数据类型 说明
deviceId string 仅供输出。设备的 ID,由服务器分配。
deviceIdentifier object(DeviceIdentifier) 用于标识制造设备的硬件 ID。
customer object(CompanyReference) 公司 ID,用于标识设备分配给哪家公司。
orderNumber string 订单号。
vendorParams map 供应商指定的键值对中的额外字段。

设备标识符

封装硬件和产品 ID 以标识制造商的设备。

三星设备需要以下某一字段:

  • IMEI
  • serialNumber
  • meid

系统会忽略所有其他字段,例如 model

对于所有其他 Android 设备:

  • 移动网络设备需要 imeimanufacturer
  • 仅使用 Wi-Fi 的设备需要 serialNumbermanufacturermodel
字段名称 数据类型 说明
imei string 设备的 IMEI 识别码。经输入验证。
serialNumber string 设备的制造商序列号。此值在不同设备型号上可能不是唯一的。
meid string 设备的 MEID 号。
manufacturer string 设备制造商的名称。与从 android.os.Build.MANUFACTURER 返回的设备的内置值匹配。制造商中列出了允许的值。
model string 设备型号的名称。与从 android.os.Build.MODEL 返回的设备的内置值匹配。允许的值列在模型中。

操作

此资源包含异步 API 调用的状态。有四种可能的状态:

  • IN_PROGRESS:操作正在进行。
  • COMPLETE:已成功处理所有设备。
  • COMPLETE_WITH_ERRORS:操作已处理,但发生了一些错误。所有错误都列在 deviceErrors 列表中。
  • FAILED:操作失败,并且不会返回 operationId
字段名称 数据类型 说明
operationId string 操作 ID,带有 samsung/google/ 前缀。如果为空,则 stateFAILED
operationType enum(operationType) 操作类型:CLAIM_DEVICESUNCLAIM_DEVICES
state enum(operationState) 操作状态:IN_PROGRESSCOMPLETECOMPLETE_WITH_ERRORSFAILED
deviceErrors object(DeviceOperationError)列表 设备操作错误列表。
vendorParams map 供应商指定的键值对中的额外字段。

设备操作错误

Operation 中的设备特定错误。每个资源包含的 deviceIddeviceIdentifier 与启动操作的请求相同。

字段名称 数据类型 说明
deviceId string 仅供输出。设备的 ID,由服务器分配。
deviceIdentifier object(DeviceIdentifier) 用于标识制造设备的硬件 ID。
error object(Error) 设备操作错误。

CommonException

可由所有同步 API 抛出的异常。

属性名称 价值 说明
error object(Error) 同步操作错误。

错误

一个对象,其中包含有关错误的详细信息。

属性名称 价值 说明
code enum(ErrorCode) 错误代码。例如 INVALID_REQUESETPERMISSION_DENIED
message string 错误消息。
vendorMsg string 供应商对错误的详细说明。
errorId string 内部错误标识符。
vendorParams map 供应商指定的键值对中的额外字段。

ErrorCode

常见错误。

枚举 说明
INVALID_PARAM_DEFAULT 未指定的输入参数无效。如需了解详情,请查看 vendorMsg。
INVALID_PAGE_TOKEN 提供的 pageToken 无效。
INVALID_CUSTOMER_ID 提供的 customerId 无效。
INVALID_DEVICE_IMEI IMEI 无效。
INVALID_DEVICE_MEID MEID 无效。
INVALID_DEVICE_SERIAL 序列号无效。
INVALID_OPERATION_ID 提供的操作 ID 无效。
INVALID_RESELLER_ID 提供的 resellerId 无效。
INVALID_MANUFACTURER 提供的制造商无效 / 不受支持。
INVALID_IDENTIFIER_SET 提供的标识符集不足以满足请求。如需详细了解允许的标识符集,请参阅 DeviceIdentifier
INVALID_MODEL 提供的模型无效 / 不受支持。
INVALID_DEVICE_ID 提供的 deviceId 无效。
INVALID_DEVICE 提供的设备不存在。这是三星特有的错误代码。
DUPLICATE_DEVICE 该设备之前已被同一客户申领。无需采取纠正措施。
DEVICE_UPLOAD_COUNT_EXCEEDED 该请求包含的设备数量超出上限(目前为 10 万)。
AUTHORIZATION_FAIL 您无权访问指定资源(例如设备、客户),或者该资源不存在。如需了解详情,请访问 vendorMsg
INTERNAL_SERVER_ERROR 未指定的内部服务器错误。如需了解详情,请查看 vendorMsg。可以根据服务器错误的性质重试这些请求。
NOT_IMPLEMENTED 服务器不支持请求方法。