---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/dev/direct/doc/en/sitelinks/add.md
  - https://yandex.ru/dev/direct/doc/ru/sitelinks/add.md
sourcePath: ru/ref-v5/sitelinks/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}

Не более 1000 наборов быстрых ссылок в одном вызове метода.

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


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

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

```javascript translate=no
{
  "method": "add",
  "params": { /* params */
    "SitelinksSets": [{  /* SitelinksSetAddItem */
      "Sitelinks": [{  /* Sitelink */
        "Title": (string), /* required */
        "Href": (string),
        "Description": (string),
        "TurboPageId": (long)
       }, ... ] /* required */
    }, ... ] /* required */
  }
}
```


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

||
**Структура params (для JSON) / AddRequest (для SOAP)**
||
||
`SitelinksSets`
|
array of SitelinksSetAddItem
|
Наборы быстрых ссылок, которые требуется добавить.
|
Да
||

||
**Структура SitelinksSetAddItem**
||
||
`Sitelinks`
|
array of Sitelink
|
Набор быстрых ссылок. От 1 до 8 элементов в массиве.
|
Да
||

||
**Структура Sitelink**
||
||
`Title`
|
string
|
Текст быстрой ссылки (не более 30 символов).
|
Да
||
||
`Href`
|
string
|
Ссылка на сайт, куда будет вести объявление (не более 1024 символов). Должна содержать протокол и доменное имя. Может содержать [подстановочные переменные](https://yandex.ru/support/direct/statistics/url-tags.html).


{% note alert %}

В быстрых ссылках подстановка значений переменных `{campaign_id}`, `{ad_id}`, `{banner_id}`, `{phrase_id}` гарантируется только при наличии этих же переменных в основной ссылке объявления.

{% endnote %}
|
Хотя бы один из параметров `Href` или `TurboPageId` (могут присутствовать оба)
||
||
`TurboPageId`
|
long
|
Идентификатор Турбо-страницы.
||
||
`Description`
|
string
|
Описание быстрой ссылки (не более 60 символов) для отображения объявления в расширенном формате.
|
Нет
||
|# 


## Ответ {#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)
|
Ошибки, возникшие при выполнении операции.
||
|#