公司参考资料
为公司唯一标识。
字段名称 | 数据类型 | 说明 |
---|---|---|
companyId |
string |
仅供输出。公司的 ID,由服务器分配。 |
vendor |
enum |
Samsung 或 Google 。 |
公司
表示公司。
字段名称 | 数据类型 | 说明 |
---|---|---|
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 设备:
- 移动网络设备需要
imei
和manufacturer
。 - 仅使用 Wi-Fi 的设备需要
serialNumber
、manufacturer
和model
。
字段名称 | 数据类型 | 说明 |
---|---|---|
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/ 前缀。如果为空,则 state 为 FAILED 。 |
operationType |
enum(operationType) |
操作类型:CLAIM_DEVICES 或 UNCLAIM_DEVICES 。 |
state |
enum(operationState) |
操作状态:IN_PROGRESS 、COMPLETE 、COMPLETE_WITH_ERRORS 、FAILED 。 |
deviceErrors |
object( DeviceOperationError ) 列表 |
设备操作错误列表。 |
vendorParams |
map |
供应商指定的键值对中的额外字段。 |
设备操作错误
Operation
中的设备特定错误。每个资源包含的 deviceId
和 deviceIdentifier
与启动操作的请求相同。
字段名称 | 数据类型 | 说明 |
---|---|---|
deviceId |
string |
仅供输出。设备的 ID,由服务器分配。 |
deviceIdentifier |
object( DeviceIdentifier ) |
用于标识制造设备的硬件 ID。 |
error |
object( Error ) |
设备操作错误。 |
CommonException
可由所有同步 API 抛出的异常。
属性名称 | 价值 | 说明 |
---|---|---|
error |
object( Error ) |
同步操作错误。 |
错误
一个对象,其中包含有关错误的详细信息。
属性名称 | 价值 | 说明 |
---|---|---|
code |
enum( ErrorCode ) |
错误代码。例如 INVALID_REQUESET 或 PERMISSION_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 |
服务器不支持请求方法。 |