---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/direct/doc/en/advideos/add.md
  - https://yandex.ru/dev/direct/doc/ru/advideos/add.md
  - href: ru/advideos/add.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/ref-v5/advideos/add.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt

# add

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

## Запрос {#input}

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

```javascript translate=no
{
   "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 символов). | ^ ||

|# 

## Ответ {#output}

{% note alert %}

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

{% endnote %}


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

```javascript translate=no
{
   "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 | Идентификационный номер видео.  ||
|#