КомпанияСсылка
Уникально идентифицирует компанию.
Имя поля | Тип данных | Описание |
---|---|---|
companyId | string | Только вывод. ID компании, присвоенный сервером. |
vendor | enum | Samsung или Google . |
Компания
Представляет компанию.
Имя поля | Тип данных | Описание |
---|---|---|
companyReference | object( CompanyReference ) | Справочный объект компании. |
companyName | string | Название компании. Например , компания XYZ . Отображается для сотрудников компании на портале автоматической регистрации. |
vendorParams | map | Дополнительные поля в парах ключ-значение, указанные поставщиком. |
Устройство
Устройство Android, зарегистрированное для регистрации.
Имя поля | Тип данных | Описание |
---|---|---|
deviceId | string | Только вывод. Идентификатор устройства, присвоенный сервером. |
deviceIdentifier | object( DeviceIdentifier ) | Идентификаторы оборудования, которые идентифицируют изготовленное устройство. |
customer | object( CompanyReference ) | Идентификаторы компаний, которые определяют, какой компании назначены устройства. |
orderNumber | string | Номер заказа. |
vendorParams | map | Дополнительные поля в парах ключ-значение, указанные поставщиком. |
Идентификатор устройства
Инкапсулирует идентификаторы оборудования и продукта для идентификации устройства производителя.
Для устройств Samsung необходимо заполнить одно из следующих полей:
-
IMEI
-
serialNumber
-
meid
Все остальные поля, такие как model
, игнорируются.
Для всех остальных устройств Android:
- Для сотовых устройств требуется
imei
иmanufacturer
. - Для устройств только с WiFi требуются
serialNumber
,manufacturer
иmodel
.
Имя поля | Тип данных | Описание |
---|---|---|
imei | string | Номер IMEI устройства. Проверяется при вводе. |
serialNumber | string | Серийный номер производителя устройства. Это значение может быть не уникальным для разных моделей устройств. |
meid | string | Номер MEID устройства. |
manufacturer | string | Название производителя устройства. Соответствует встроенному значению устройства, возвращенному из android.os.Build.MANUFACTURER . Допустимые значения указаны у производителей . |
model | string | Название модели устройства. Соответствует встроенному значению устройства, возвращенному из android.os.Build.MODEL . Допустимые значения перечислены в models . |
Операция
Этот ресурс содержит состояние асинхронного вызова API. Возможны четыре состояния:
-
IN_PROGRESS
: операция выполняется. -
COMPLETE
: Все устройства успешно обработаны. -
COMPLETE_WITH_ERRORS
: операция была обработана, но возникли некоторые ошибки. Все ошибки перечислены в спискеdeviceErrors
. -
FAILED
: операция завершилась неудачно, иoperationId
не возвращается.
Имя поля | Тип данных | Описание |
---|---|---|
operationId | string | Идентификатор операции с префиксом 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 | Только вывод. Идентификатор устройства, присвоенный сервером. |
deviceIdentifier | object( DeviceIdentifier ) | Идентификаторы оборудования, которые идентифицируют изготовленное устройство. |
error | object( Error ) | Ошибка работы устройства. |
Общее исключение
Исключение, которое может создаваться всеми синхронными API.
Имя свойства | Ценить | Описание |
---|---|---|
error | object( Error ) | Ошибка синхронной работы. |
Ошибка
Объект, содержащий сведения об ошибке.
Имя свойства | Ценить | Описание |
---|---|---|
code | enum( ErrorCode ) | Код ошибки. Например, INVALID_REQUESET или PERMISSION_DENIED |
message | string | Сообщение об ошибке. |
vendorMsg | string | Подробное объяснение ошибки от продавца. |
errorId | string | Внутренний идентификатор ошибки. |
vendorParams | map | Дополнительные поля в парах ключ-значение, указанные поставщиком. |
Код ошибки
Распространенные ошибки.
перечисление | Описание |
---|---|
INVALID_PARAM_DEFAULT | Не указан недопустимый входной параметр. Посмотрите на vendorMsg, чтобы получить более подробную информацию. |
INVALID_PAGE_TOKEN | Предоставленный pageToken недействителен. |
INVALID_CUSTOMER_ID | Предоставленный идентификатор клиента недействителен. |
INVALID_DEVICE_IMEI | Неверный IMEI. |
INVALID_DEVICE_MEID | Неверный MEID. |
INVALID_DEVICE_SERIAL | Неправильный серийный номер. |
INVALID_OPERATION_ID | Указанный идентификатор операции недействителен. |
INVALID_RESELLER_ID | Указанный resellerId недействителен. |
INVALID_MANUFACTURER | Указанный производитель недействителен / не поддерживается. |
INVALID_IDENTIFIER_SET | Предоставленный набор идентификаторов недостаточен для запроса. Дополнительные сведения о разрешенных наборах идентификаторов см. в разделе DeviceIdentifier . |
INVALID_MODEL | Предоставленная модель недействительна / не поддерживается. |
INVALID_DEVICE_ID | Указанный идентификатор устройства недействителен. |
INVALID_DEVICE | Предоставленное устройство не существует. Это специфический код ошибки Samsung. |
DUPLICATE_DEVICE | Ранее устройство было заявлено этому же заказчику. Никаких корректирующих действий не требуется. |
DEVICE_UPLOAD_COUNT_EXCEEDED | Запрос содержит больше устройств, чем ограничение (в настоящее время 100 тыс.). |
AUTHORIZATION_FAIL | У вас нет доступа к данному ресурсу (например, устройству, клиенту) или ресурс не существует. Посмотрите на vendorMsg , чтобы получить более подробную информацию. |
INTERNAL_SERVER_ERROR | Неизвестная внутренняя ошибка сервера. Посмотрите на vendorMsg, чтобы получить более подробную информацию. Эти запросы можно повторить в зависимости от характера ошибки сервера. |
NOT_IMPLEMENTED | Метод запроса не поддерживается сервером. |