Upload

Выполняет асинхронную загрузку изображений по списку URL. Синхронный ответ содержит номера заданий на загрузку.

Входные данные

Ниже показана структура входных данных в формате JSON.

{
   "method": "AdImage",
   "param": {
      /* AdImageRequest */
      "Action": (string),
      "AdImageURLData": [
         {  /* AdImageURL */
            "Login": (string),
            "URL": (string),
            "Name": (string)
         }
         ...
      ]
   }
}

Ниже приведено описание параметров.

Параметр Описание Требуется
Объект AdImageRequest
Action Выполняемая операция: Upload. Да
AdImageURLData Массив объектов AdImageURL (не более 10 000), содержащих информацию о загружаемых изображениях. Да
Объект AdImageURL
Login

Логин клиента — владельца изображения.

Для рекламодателей параметр игнорируется.

 Для агентств
URL Ссылка на изображение. Да
Name Произвольное наименование (описание) изображения. Да
Параметр Описание Требуется
Объект AdImageRequest
Action Выполняемая операция: Upload. Да
AdImageURLData Массив объектов AdImageURL (не более 10 000), содержащих информацию о загружаемых изображениях. Да
Объект AdImageURL
Login

Логин клиента — владельца изображения.

Для рекламодателей параметр игнорируется.

 Для агентств
URL Ссылка на изображение. Да
Name Произвольное наименование (описание) изображения. Да

Результирующие данные

Внимание. Ошибка при создании задания на загрузку (постановке в очередь) одного из изображений не влечет отмену всей операции и не влияет на успешность создания заданий на загрузку остальных изображений.

Ниже показана структура результирующих данных в формате JSON.

{
   "data": {
      /* AdImageResponse */
      "ActionsResult": [
         {  /* AdImageActionResult */
            "AdImageUploadTaskID": (int),
            "Errors": [
               {  /* Error */
                  "FaultCode": (int),
                  "FaultString": (string),
                  "FaultDetail": (string)
               }
               ...
            ],
         }
         ...
      ]
   }
}

Ниже приведено описание параметров.

Параметр Описание
Объект AdImageResponse
ActionsResult

Массив объектов AdImageActionResult. Каждый объект соответствует элементу входного массива AdImageURLData и содержит:

  • в случае успешной постановки изображения в очередь — номер задания на загрузку;
  • в случае ошибки — массив Errors.

Элементы массива следуют в том же порядке, что и объекты входного массива AdImageURL.
Объект AdImageActionResult
AdImageUploadTaskID Номер созданного задания на загрузку. Номер можно использовать для проверки статуса загрузки с помощью операции CheckUploadStatus.
Errors Массив объектов Error — ошибок, возникших при постановке изображений в очередь на загрузку.
Объект Error
FaultCode Код ошибки.
FaultString Текст сообщения об ошибке.
FaultDetail Подробное описание причины ошибки.
Параметр Описание
Объект AdImageResponse
ActionsResult

Массив объектов AdImageActionResult. Каждый объект соответствует элементу входного массива AdImageURLData и содержит:

  • в случае успешной постановки изображения в очередь — номер задания на загрузку;
  • в случае ошибки — массив Errors.

Элементы массива следуют в том же порядке, что и объекты входного массива AdImageURL.
Объект AdImageActionResult
AdImageUploadTaskID Номер созданного задания на загрузку. Номер можно использовать для проверки статуса загрузки с помощью операции CheckUploadStatus.
Errors Массив объектов Error — ошибок, возникших при постановке изображений в очередь на загрузку.
Объект Error
FaultCode Код ошибки.
FaultString Текст сообщения об ошибке.
FaultDetail Подробное описание причины ошибки.

Примеры входных данных

Python

{
   'Action': 'Upload',
   'AdImageURLData': [
      {
         'Login': 'agrom',
         'URL': 'http://site.ru/files/image001.png',
         'Name': u'Слоны: новая коллекция'
      },
      {
         'Login': 'agrom',
         'URL': 'http://site.ru/files/image002.png',
         'Name': u'Слоны: сертификация и обслуживание'
      },
      {
         'Login': 'larry',
         'URL': 'http://example.net/files/pic.png',
         'Name': u'Сухари впрок'
      }
   ]
}

PHP

array(
   'Action' => 'Upload',
   'AdImageURLData' => array(
      array(
         'Login' => 'agrom',
         'URL' => 'http://site.ru/files/image001.png',
         'Name' => 'Слоны: новая коллекция'
      ),
      array(
         'Login' => 'agrom',
         'URL' => 'http://site.ru/files/image002.png',
         'Name' => 'Слоны: сертификация и обслуживание'
      ),
      array(
         'Login' => 'larry',
         'URL' => 'http://example.net/files/pic.png',
         'Name' => 'Сухари впрок'
      )
   )
)

Perl

{
   'Action' => 'Upload',
   'AdImageURLData' => [
      {
         'Login' => 'agrom',
         'URL' => 'http://site.ru/files/image001.png',
         'Name' => 'Слоны: новая коллекция'
      },
      {
         'Login' => 'agrom',
         'URL' => 'http://site.ru/files/image002.png',
         'Name' => 'Слоны: сертификация и обслуживание'
      },
      {
         'Login' => 'larry',
         'URL' => 'http://example.net/files/pic.png',
         'Name' => 'Сухари впрок'
      },
   ]
}