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

# add

Выполняет синхронную загрузку изображений в виде бинарных данных.

## Узнайте больше

- [Как работает метод add](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html)
- [Как обрабатывать ошибки](https://yandex.ru/dev/direct/doc/dg/concepts/errors.html)


## Ограничения {#restrictions}

Количество изображений у пользователя не может превышать 1000 + 2 × количество объявлений.

Не более 100 изображений в одном вызове метода. Рекомендуем загружать не более 3 изображений в одном вызове.

Если изображения идентичны, то будет создано только одно изображение.

Ограничения на размер изображения представлены в разделе [Требования к изображениям, загружаемым через API](https://yandex.ru/dev/direct/doc/dg/objects/adimage.html#requirements).


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

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

```javascript translate=no
{
  "method": "add",
  "params": { /* params */
    "AdImages": [{  /* AdImageAddItem */
      "ImageData": (base64Binary), /* required */
      "Type" : ("REGULAR" | "WIDE" | "FIXED_IMAGE" | "AUTO" ),
      "Name": (string) /* required */
    }, ... ] /* required */
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||
||
**Структура params (для JSON) / AddRequest (для SOAP)**
|
>
|
>
|
>
||
||
`AdImages`
|
array of AdImageAddItem
|
Изображения, которые требуется добавить (не более 100).
|
Да
||
||
**Структура AdImageAddItem**
|
>
|
>
|
>
||
||
`ImageData`
|
base64Binary
|
Загружаемое изображение: бинарные данные, закодированные в base64.


{% note info %}

При использовании SOAP-библиотеки в это поле следует поместить непосредственно бинарные данные, а библиотека автоматически при передаче закодирует их в base64.

При использовании формата JSON следует предварительно закодировать бинарные данные в base64 и передать их как строку.

{% endnote %}
|
Да
||
||
`Type`
|
AdImageAddTypeEnum
|
Тип изображения. Cм. [здесь](https://yandex.ru/dev/direct/doc/dg/objects/adimage.html#type).

Тип определяется автоматически, если значение `Type` не указано или указано значение `AUTO`.

Если изображение подходит к двум типам, например, `FIXED_IMAGE` и `REGULAR/WIDE`, то будет выбран тип `REGULAR/WIDE`.
|
Нет
||
||
`Name`
|
string
|
Произвольное наименование изображения. Не более 255 символов.
|
Да
||
|# 


## Ответ {#output}

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

```javascript translate=no
{
  "result": { /* result */
    "AddResults": [{  /* AdImageActionResult */
      "AdImageHash": (string),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ]
    }, ... ]
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
||
||
**Структура result (для JSON) / AddResponse (для SOAP)**
|
>
|
>
||
||
`AddResults`
|
array of AdImageActionResult
|
Результаты добавления изображений.
||
||
**Структура AdImageActionResult**
|
>
|
>
||
||
`AdImageHash`
|
string
|
Хэш изображения. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html).
||
||
`Warnings`
|
array of ExceptionNotification
|
Предупреждения, возникшие при выполнении операции.
||
||
`Errors`
|
array of ExceptionNotification
|
Ошибки, возникшие при выполнении операции.
||
|# 


## Пример {#samples}

```javascript translate=no
{
  "method": "add",
  "params": {
    "AdImages": [{
      "ImageData": "iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAA...",
      "Name": "elephants.jpg"
    }]
  }
}
```