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 символов).

Ответ

Внимание

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

Структура ответа в формате 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

Идентификационный номер видео.

Следующая