Поставить кампанию на паузуправка·опасно
Останавливает показы кампании.
Возобновить кампаниюправка·опасно
Снимает кампанию с паузы. Показы и РАСХОД БЮДЖЕТА начинаются сразу, потраченное вернуть нельзя — вызывайте только после явной просьбы пользователя возобновить именно эту кампанию.
Изменить дневной бюджет (отключён)правка·опасно
ОТКЛЮЧЁН: Direct убрал дневной бюджет (DailyBudget) 22 августа 2026, инструмент оставлен только для совместимости и ничего не меняет. Задавайте недельный бюджет через set_weekly_budget.
Изменить недельный бюджетправка·опасно
Устанавливает НЕДЕЛЬНЫЙ бюджет кампании, руб (WeeklySpendLimit). Работает на АВТОСТРАТЕГИЯХ. У кампаний с ручными ставками бюджет задаётся только в интерфейсе Яндекс Директа: дневной бюджет Директ отключил 22 августа 2026, а обещанная замена в API пока не развёрнута. В этом случае так и скажите пользователю и предложите либо задать бюджет в кабинете Директа, либо перевести кампанию на автостратегию. Если кампания состоит в пакетной стратегии, Директ не даёт менять её стратегию, ключевые цели, счётчики и модель атрибуции — об этом сказано в ответе полями packageStrategy*, перескажите их пользователю.
Сменить стратегию кампанииправка·опасно
Меняет стратегию показов. weeklyBudget применяется только к автостратегиям: на ручной (MANUAL) недельный бюджет через campaigns API не задаётся вообще и будет отброшен. Для MAX_PROFIT и multi-goal передай goals [{goalId,value}]. networkType управляет показами в сетях (РСЯ): SERVING_OFF ОТКЛЮЧАЕТ показы в сетях целиком — назови это последствие пользователю до вызова. Без networkType сеть кампании остаётся прежней. То же, что set_campaign_strategy (исторический синоним).
Изменить стратегию кампанииправка·опасно
Меняет стратегию показов. weeklyBudget применяется у автостратегий; при переводе на MANUAL он НЕ переносится — на ручных ставках недельный бюджет задаётся пакетной стратегией Директа, вне коннектора. Поддержаны также MAX_PROFIT и стратегии по нескольким целям; для них передай goals [{goalId,value}], где value — маржа или индивидуальный CPA. networkType управляет показами в сетях (РСЯ): SERVING_OFF ОТКЛЮЧАЕТ показы в сетях целиком — назови это последствие пользователю до вызова. Если networkType не указан, сеть остаётся такой, как в кампании сейчас.
Задать цели-конверсии кампанииправка·опасно
Задаёт приоритетные цели («цели, считающиеся конверсиями») кампании из списка list_campaign_goals. Заменяет весь набор. conversionValue (₽) — ценность конверсии, нужна для стратегии «Целевой ROAS» и денежной аналитики (для лидов — маржа с заявки). Пустой goalIds — снять все цели.
Изменить ставку ключаправка·опасно
Устанавливает ставку по ключевой фразе, руб.
Добавить ключевые фразыправка
Добавляет ключевые фразы в группу объявлений. Возвращает id добавленных ключей.
Удалить ключевую фразуправка·опасно
Удаляет ключевую фразу по id.
Добавить минус-словаправка
Добавляет минус-слова в кампанию (отсекает нецелевой трафик). Список кампании ограничен 1000 фразами — Директ отвергает запись целиком, если итоговый список длиннее, поэтому длинный набор надо делить по кампаниям, а не слать одним куском.
Убрать минус-словаправка·опасно
Убирает минус-слова из кампании (откат ошибочной минусовки: минус-слово режет целевой трафик так же молча, как и мусорный). Слова, которых нет в списке, игнорируются. За один вызов принимается не больше 1000 фраз — столько же, сколько Директ вообще держит в списке кампании.
Корректировки ставокправка·опасно
Задаёт корректировки ставок кампании или конкретной группы (если передан adGroupId) по срезам. dimension: device | gender | age. value для device: «Мобильные», «Десктоп» или «Планшеты»; для gender: «Женщины»/«Мужчины»; для age: «18-24», «25-34», «45-54» и т.п. pct — знаковый процент: -100 = отключить срез, 0 = нейтраль, +30 = поднять на 30%. Весь пакет валидируется до обращения к Direct API. Upsert: существующая корректировка среза обновляется. Текущие значения — get_bid_adjustments.
Изменить текст объявленияправка·опасно
Обновляет обычное или комбинаторное объявление. ⚠️ Для комбинаторного titles и descriptions ЗАМЕНЯЮТ текущий набор вариантов ЦЕЛИКОМ — Direct перезаписывает массивы, а не дополняет их, поэтому передавайте полный набор: 2–7 заголовков и 2–3 текста. Одиночный вариант отклоняется до запроса, иначе он стёр бы остальные безвозвратно. Чтобы поменять только ссылку, titles/descriptions не передавайте вовсе — сервис сохранит текущие. Для обычного объявления — title/title2/text.
Изменить текст ключевой фразыправка·опасно
Меняет текст ключа с сохранением операторов и минус-слов. Перед записью проверяет дубликат в группе; ставку переносит best-effort, если Direct вернул новый ID. Операция составная, не атомарная.
Изменить расширения объявленияправка·опасно
Заменяет быстрые ссылки и/или уточнения объявления. Пустой массив снимает соответствующее расширение.
Вернуть расширения к наследованиюправка·опасно
Снимает переопределение быстрых ссылок и/или уточнений на объявлении. Параметры независимы.
Пресеты расширенийчтение
Список прикладных пресетов быстрых ссылок и уточнений кампании/группы.
Сохранить пресет расширенийправка·опасно
Создаёт или обновляет пресет кампании/группы. null снимает управление конкретным полем, [] явно убирает расширение.
Удалить пресет расширенийправка·опасно
Удаляет только прикладной пресет; текущие расширения объявлений в Direct не меняет.
Применить пресет расширенийправка·опасно
Пакетно применяет эффективные расширения к объявлениям кампании. По умолчанию только показывает план; для записи передайте dryRun=false.
Добавить аудиторию ретаргетингаправка·опасно
Привязывает сегмент ретаргетинга к кампании с корректировкой ставки. bidPct — знаковый процент: -100 отключает показы, 0 без корректировки, +30 повышает ставку на 30%.
Удалить аудиторию ретаргетингаправка·опасно
Удаляет привязку аудитории по ID корректировки. Список текущих привязок — через list_audiences.