add

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

Запрос

Структура запроса в формате JSON.

{
   "method": "add",
   "params" : { /* required */
        "AdVideos" : [{ /* AdVideoAddItem */
            "Url" : (string),
            "VideoData" : (base64Binary),
            "Name" : (string)
        }, .. ]
    }
}
Параметр Тип Описание Обязательный
Структура params (для JSON) / AddRequest (для SOAP)
AdVideos array of AdVideoAddItem Видео, которые требуется добавить (не более 10 для ссылок URL и не более 1 для бинарных данных). Да
Структура AdVideoAddItem
URL string Ссылка на видео. Либо URL, либо VideoData и Name
VideoData base64Binary Загружаемое видео: бинарные данные, закодированные в base64.
Name string Произвольное наименование видео (до 255 символов).
Параметр Тип Описание Обязательный
Структура params (для JSON) / AddRequest (для SOAP)
AdVideos array of AdVideoAddItem Видео, которые требуется добавить (не более 10 для ссылок URL и не более 1 для бинарных данных). Да
Структура AdVideoAddItem
URL string Ссылка на видео. Либо URL, либо VideoData и Name
VideoData base64Binary Загружаемое видео: бинарные данные, закодированные в base64.
Name string Произвольное наименование видео (до 255 символов).

Ответ

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

Структура ответа в формате JSON.

{
   "result" : { /* required */
       "AddResults" : [{
           "Warnings" : [{
               "Code" : (integer) /* required */,
               "Message" : (string) /* required */,
               "Details" : (string)
            }, .. (unbounded)],
           "Errors" : [{
               "Code" : (integer) /* required */,
               "Message" : (string) /* required */,
               "Details" : (string)
            }, .. ],
           "Id" : (string)
        }, ... ]
    }
}
Параметр Тип Описание
Структура result (для JSON) / AddResponse (для SOAP)
AddResults array of VideoActionResult

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

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

Элементы массива следуют в том же порядке, что и объекты входного массива AdVideoAddItem.
Структура AddResults
Warnings array of ExceptionNotification Массив объектов Warnings — предупреждений, возникших при постановке видео в очередь на загрузку.
Errors array of ExceptionNotification Массив объектов Error — ошибок, возникших при постановке видео в очередь на загрузку.
Id array of ExceptionNotification Идентификационный номер видео.
Параметр Тип Описание
Структура result (для JSON) / AddResponse (для SOAP)
AddResults array of VideoActionResult

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

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

Элементы массива следуют в том же порядке, что и объекты входного массива AdVideoAddItem.
Структура AddResults
Warnings array of ExceptionNotification Массив объектов Warnings — предупреждений, возникших при постановке видео в очередь на загрузку.
Errors array of ExceptionNotification Массив объектов Error — ошибок, возникших при постановке видео в очередь на загрузку.
Id array of ExceptionNotification Идентификационный номер видео.