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 Произвольное наименование (описание) изображения. Да

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

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

Ниже показана структура результирующих данных в формате 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 Подробное описание причины ошибки.

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

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' => 'Сухари впрок'
      },
   ]
}