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

Была ли статья полезна?

AdImage (Live)

CheckUploadStatus