add
Создает наборы быстрых ссылок.## Узнайте больше
Ограничения
Не более 1000 наборов быстрых ссылок в одном вызове метода.
Если у наборов все поля идентичны, то будет создан только один набор.
Запрос
Структура запроса в формате JSON:
{
"method": "add",
"params": { /* params */
"SitelinksSets": [{ /* SitelinksSetAddItem */
"Sitelinks": [{ /* Sitelink */
"Title": (string), /* required */
"Href": (string),
"Description": (string),
"TurboPageId": (long)
}, ... ] /* required */
}, ... ] /* required */
}
}
Параметр |
Тип |
Описание |
Обязательный |
Структура params (для JSON) / AddRequest (для SOAP) |
|||
|
array of SitelinksSetAddItem |
Наборы быстрых ссылок, которые требуется добавить. |
Да |
Структура SitelinksSetAddItem |
|||
|
array of Sitelink |
Набор быстрых ссылок. От 1 до 8 элементов в массиве. |
Да |
Структура Sitelink |
|||
|
string |
Текст быстрой ссылки (не более 30 символов). Суммарная длина текстов быстрых ссылок № 1–4 — не более 66 символов. Суммарная длина текстов быстрых ссылок № 5–8 — также не более 66 символов. |
Да |
|
string |
Ссылка на сайт рекламодателя (не более 1024 символов). Должна содержать протокол и доменное имя. Может содержать подстановочные переменныеподстановочные переменные. Внимание В быстрых ссылках подстановка значений переменных |
Хотя бы один из параметров |
|
long |
Идентификатор Турбо-страницы. |
|
|
string |
Описание быстрой ссылки (не более 60 символов) для отображения объявления в расширенном формате. |
Нет |
Ответ
Структура ответа в формате JSON:
{
"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) |
||
|
array of ActionResult |
Результаты добавления наборов быстрых ссылок. |
Объект ActionResult |
||
|
long |
Идентификатор созданного набора быстрых ссылок. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов. |
|
array of ExceptionNotification |
Предупреждения, возникшие при выполнении операции. |
|
array of ExceptionNotification |
Ошибки, возникшие при выполнении операции. |