---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/dev/direct/doc/en/feeds/add.md
  - https://yandex.ru/dev/direct/doc/ru/feeds/add.md
sourcePath: ru/ref-v5/feeds/add.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/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}

Не более 50 фидов у одного пользователя.

Не более 50 фидов в одном вызове метода.

[Требования к фиду](https://yandex.ru/support/direct/ru/feeds/requirements).

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


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

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

```javascript translate=no
{
  "method": "add",
  "params": { /* params */
    "Feeds": [{ /* FeedAddItem */
      "Name": (string), /* required */
      "BusinessType": ( "RETAIL" | "HOTELS" | "REALTY" | "AUTOMOBILES" | "FLIGHTS" | "OTHER" ), /* required */
      "SourceType": ( "URL" | "FILE" ), /* required */
      "UrlFeed": { /* UrlFeedAdd */
        "Url": (string), /* required */
        "RemoveUtmTags": ( "YES" | "NO" ),
        "Login": (string),
        "Password": (string),
      },
      "FileFeed": { /* FileFeedAdd */
        "Data": (base64Binary), /* required*/
        "Filename": (string) /* required */
      }
    }, ... ] /* required */
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
**Структура params (для JSON) / AddRequest (для SOAP)**
||
||
`Feeds`
|
array of FeedAddItem
|
Фиды, которые требуется добавить (не более 50).
|
Да
||

||
**Структура FeedAddItem**
||
||
`Name`
|
string
|
Название фида. Не более 255 символов.
|
Да
||
||
`BusinessType`
|
BusinessTypeEnum
|
Тип бизнеса. Определяет доступные форматы фида. См. [Тип бизнеса для фида](https://yandex.ru/dev/direct/doc/dg/objects/feed.html).
|
Да
||
||
`SourceType`
|
SourceTypeEnum
|
Тип источника данных:
- URL — фид доступен по ссылке.
- FILE — фид передан в запросе.
|
Да
||
||
`UrlFeed`
|
UrlFeedAdd
|
Параметры фида, доступного по ссылке.
|
Либо `UrlFeed`, либо `FileFeed`
||
||
`FileFeed`
|
FileFeedAdd
|
Параметры фида, переданного в запросе.
||

||
**Структура UrlFeed**
||
||
`Url`
|
string
|
Ссылка на фид. Не более 1024 символов. Должна содержать протокол и доменное имя.
|
Да
||
||
`RemoveUtmTags`
|
YesNoEnum
|
Автоматически удалять UTM-метки из ссылок в фиде. Значение по умолчанию — NO.
|
Нет
||
||
`Login`
|
string
|
Логин для доступа к фиду (если требуется). Не более 50 символов.
|
Нет
||
||
`Password`
|
string
|
Пароль для доступа к фиду (если требуется).
|
Нет
||

||
**Структура FileFeedAdd**
||
||
`Data`
|
base64Binary
|
Загружаемый фид, закодированный в base64. Размер фида ограничен общим размером запроса — не более 50 Мб.


{% note info %}

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

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

{% endnote %}
|
Да
||
||
`Filename`
|
string
|
Имя файла фида. Не более 255 символов.
|
Да
||
|# 


## Ответ {#output}

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

```javascript translate=no
{
  "result": { /* result */
    "AddResults": [{  /* ActionResult */
      "Id": (long),
      "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 ActionResult
|
Результаты добавления фидов.
||

||
**Структура ActionResult**
||
||
`Id`
|
long
|
Идентификатор фида. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html).
||
||
`Warnings`
|
array of [ExceptionNotification](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html)
|
Предупреждения, возникшие при выполнении операции.
||
||
`Errors`
|
array of [ExceptionNotification](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html)
|
Ошибки, возникшие при выполнении операции.
||
|# 


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

```javascript translate=no
{
  "method": "add",
  "params": {
    "Feeds": [{
      "Name": "MyFeed",
      "BusinessType": "RETAIL",
      "SourceType": "FILE",
      "FileFeed": {
        "Data": "iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAA..."
        "Filename": "myfeed.xml"
      }
    }]
  }
}
```