Объекты

КомпанияСсылка

Уникально идентифицирует компанию.

Имя поля Тип данных Описание
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 Метод запроса не поддерживается сервером.