--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.ru/dev/direct/doc/en/keywords/update.md - https://yandex.ru/dev/direct/doc/ru/keywords/update.md - href: ru/keywords/update.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: ru/ref-v5/keywords/update.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt # update Изменяет параметры ключевых фраз и автотаргетингов. ## Узнайте больше - [Как работает метод update](https://yandex.ru/dev/direct/doc/ru/best-practice/principles) - [Как обрабатывать ошибки](https://yandex.ru/dev/direct/doc/ru/concepts/errors) - [Автотаргетинг](https://yandex.ru/dev/direct/doc/ru/best-practice/auto-targeting) ## Ограничения {#restrictions} Не более 1000 объектов в одном вызове метода. ## Запрос {#input} Структура запроса в формате JSON: ```javascript translate=no { "method": "update", "params": { /* params */ "Keywords": [{ /* KeywordUpdateItem */ "Id": (long), /* required */ "Keyword": (string), "UserParam1": (string), /* nillable */ "UserParam2": (string), /* nillable */ "AutotargetingCategories" : [{ /* AutotargetingCategoriesUpdateItem */ "Category" : ("EXACT"|"ALTERNATIVE"|"COMPETITOR"|"BROADER"|"ACCESSORY") /* required */, "Value" : ("YES"|"NO") /* required */ }, ...], "AutotargetingSettings" : { "Categories" : { "Exact" : ("YES"|"NO"), "Narrow" : ("YES"|"NO"), "Alternative" : ("YES"|"NO"), "Accessory" : ("YES"|"NO"), "Broader" : ("YES"|"NO") }, "BrandOptions" : { "WithoutBrands" : ("YES"|"NO"), "WithAdvertiserBrand" : ("YES"|"NO"), "WithCompetitorsBrand" : ("YES"|"NO") } } }, ... ] /* required */ } } ``` #| || **Параметр** | **Тип** | **Описание** | **Обязательный** || || **Структура params (для JSON) / UpdateRequest (для SOAP)** || || `Keywords` | array of KeywordUpdateItem | Ключевые фразы и автотаргетинги, параметры которых требуется изменить. | Да || || **Структура KeywordUpdateItem** || || `Id` | long | Идентификатор ключевой фразы или автотаргетинга. | Да || || `Keyword` | string | Ключевая фраза. Может содержать минус-слова, которые указывают со знаком минус перед словом, например _молния -гром -дождь_. Длина ключевой фразы — не более 4096 символов. Оператор `!` перед минус-словом не учитывается в длине фразы (последовательность `-!` считается как один символ). Не более 7 слов в ключевой фразе, без учета стоп-слов и минус-слов. Каждое слово — не более 35 символов, без учета минуса перед минус-словом. {% note alert %} - В результате изменения ключевой фразы может быть создана новая фраза, см. [Создание новой фразы в результате редактирования](https://yandex.ru/dev/direct/doc/dg/objects/keyword.html). - В результате изменения ключевой фразы она может быть удалена, так как стала дубликатом другой фразы, см. [Дубликаты фраз](https://yandex.ru/dev/direct/doc/dg/objects/keyword.html). {% endnote %} Для автотаргетинга значение недоступно для изменения. | Нет || || `UserParam1` | string, nillable | Значение [подстановочной переменной](https://yandex.ru/dev/direct/doc/dg/objects/keyword.html)`{param1}`. Не более 255 символов. | Нет || || `UserParam2` | string, nillable | Значение [подстановочной переменной](https://yandex.ru/dev/direct/doc/dg/objects/keyword.html)`{param2}`. Не более 255 символов. | Нет || || `AutotargetingCategories` | array of AutotargetingCategoriesUpdateItem | Категории таргетинга, которые требуется обновить. {% note alert %} Структура устарела и больше не поддерживается. Нельзя одновременно передать `AutotargetingCategories` и `AutotargetingSettings`, вернется ошибка валидации. {% endnote %} | Нет || || `AutotargetingSettings` | AutotargetingSettingsUpdateItem | Настройки таргетинга, которые требуется обновить. | Нет || || **Структура AutotargetingCategoriesUpdateItem** || || `Category` | AutotargetingCategoriesEnum | Категория таргетинга: - EXACT — целевые запросы. Объявление точно отвечает на запросы пользователя; - ALTERNATIVE — альтернативные запросы. Пользователь ищет продукт, который можно заменить продвигаемым. При этом объявление также может удовлетворить запрос; - COMPETITOR — запросы с упоминанием конкурентов. Поиск продвигаемого продукта у конкурентов; - BROADER — широкие запросы. Запросы с интересом к продукту, примером которого является предложение; - ACCESSORY — сопутствующие запросы. Запросы по продуктам, которые могут быть интересны вместе с продвигаемым товаром или услугой. {% note alert %} Поле устарело и скоро перестанет поддерживаться. Настройки, заданные с помощью API, сконвертируются в веб-интерфейсе по следующим правилам: #| || **API** | **Веб-интерфейс** || || Включенная категория `EXACT`. | - Если в группе отключены категории «Целевые», «Узкие» – Включенные категории «Целевые», «Узкие». - Если в группе включены категории «Целевые» и/или «Узкие» – без изменений. || || Выключенная категория `EXACT`. | - Если в группе включены категории «Целевые» и/или «Узкие» – Выключенные категории «Целевые», «Узкие». - Если в группе отключены категории «Целевые», «Узкие» – без изменений. || || Включенная категория `COMPETITOR` (если это единственная включенная категория). | Включенная опция упоминания брендов «Конкуренты» + отключение остальных опций упоминания брендов + включение всех категорий. || || Включенная категория `COMPETITOR` (если это не единственная включенная категория). | Включенная опция упоминания брендов «Конкуренты». || || Выключенная категория `COMPETITOR`. | Выключенная опция упоминания брендов «Конкуренты». || |# {% endnote %} | Да || || `Value` | YesNoEnum | Признак включения указанной категории таргетинга. По умолчанию включены все категории таргетинга. | Да || || **Структура AutotargetingSettingsUpdateItem** || || `Categories` | AutotargetingSettingsCategoriesFieldNames | Категории таргетинга. Доступные опции: - Exact – целевые запросы. Объявление точно отвечает на запросы пользователя. - Narrow – узкие запросы. Объявление шире, чем запросы пользователя. - Alternative – альтернативные запросы. Пользователь ищет продукт, который можно заменить продвигаемым. При этом объявление также может удовлетворить запрос. - Accessory – сопутствующие запросы. Запросы по продуктам, которые могут быть интересны вместе с продвигаемым товаром или услугой. - Broader – широкие запросы. Запросы с интересом к продукту, примером которого является предложение. | Нет || || `BrandOptions` | AutotargetingSettingsBrandOptionsFieldNames | Настройки брендовости. Доступные опции: - WithoutBrands – без упоминания брендов. - WithAdvertiserBrand – с упоминанием бренда пользователя. - WithCompetitorsBrand – с упоминанием брендов конкурентов. | Нет || |# ## Ответ {#output} Структура ответа в формате JSON: ```javascript translate=no { "result": { /* result */ "UpdateResults": [{ /* ActionResult */ "Id": (long), "Warnings": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ], "Errors": [{ /* ExceptionNotification */ "Code": (int), /* required */ "Message": (string), /* required */ "Details": (string) }, ... ] }, ... ] /* required */ } } ``` #| || **Параметр** | **Тип** | **Описание** || || **Структура result (для JSON) / UpdateResponse (для SOAP)** || || `UpdateResults` | 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) | Ошибки, возникшие при выполнении операции. || |#