Автоматизация Яндекс Директа через API: практические сценарии

Практическая автоматизация через API — общие сценарии без привязки к конкретным сервисам.

Коротко: Массовая минусовка, ежедневные проверки, сбор ключей — без ссылок на сервисы.

← Каталог API Директа · Введение · Версии API · OAuth и доступ · Сервисы v5 · Лимиты и баллы · Ограничения · Кампании · Группы и объявления · Ключи и ставки · Минус-фразы и площадки · Отчёты · Песочница · Агентства · Примеры JSON · Ошибки · Документация Яндекса

Содержание

  1. Сценарии
  2. Архитектура
  3. Расписание
  4. Лимиты
  5. Ошибки

Сценарии автоматизации

ЗадачаAPI-методыЧастота
Массовая минусовкаSEARCH_QUERY_PERFORMANCE_REPORT → campaigns.update / adgroups.update (NegativeKeywords)Еженедельно
Ежедневная проверка кампанийcampaigns.get + CAMPAIGN_PERFORMANCE_REPORTЕжедневно
Сбор ключейkeywords.add (пакетами до 1000)По запросу
Конструктор кампанийcampaigns.add → adgroups.add → ads.add → keywords.addПо событию
Проверка балансаclients.get (AccountQuality, Grants)Ежедневно
Анализ поисковых запросовSEARCH_QUERY_PERFORMANCE_REPORTЕженедельно
Чистка площадок РСЯCAMPAIGN_PERFORMANCE_REPORT (Placement) → bidmodifiers.addЕженедельно
Генератор ключейkeywords.add из внешнего источникаПо запросу
Экспорт статистикиReports API → TSV → БД/BIЕжедневно
Автоправила ставокkeywordbids.set, bidmodifiers.add по условиямЕжедневно

Архитектура скрипта

Типовая архитектура автоматизации:

  1. Scheduler (cron, systemd timer, cloud scheduler) — запуск по расписанию.
  2. Token manager — хранение и обновление OAuth refresh_token.
  3. API client — HTTP POST с заголовками Authorization, Client-Login.
  4. Rate limiter — не более 5 параллельных запросов, учёт баллов.
  5. Logger — request_id, error_code, без полных токенов.

Рекомендуемое расписание

ЗадачаВремяПриоритет
Проверка баланса08:00Высокий
Ежедневная статистика06:00Средний
Минусовка по запросамПн 07:00Средний
Чистка площадок РСЯСр 03:00Низкий
Экспорт в BI05:00Средний
Автоставки09:00Средний

Учёт лимитов

При планировании автоматизации учитывайте:

  • 5 параллельных запросов — Лимиты и баллы.
  • Суточная квота баллов — планируйте тяжёлые отчёты на ночь.
  • Для агентств — последовательная обработка клиентов, не параллельно всех.

Обработка ошибок в скриптах

  • Всегда проверяйте error в JSON ответе, даже при HTTP 200.
  • При 152 — поставьте задачу в очередь на следующий час.
  • При 53 — обновите токен и повторите.
  • Логируйте request_id для диагностики.
  • Полный справочник: Коды ошибок.

← Каталог API Директа · Введение · Версии API · OAuth и доступ · Сервисы v5 · Лимиты и баллы · Ограничения · Кампании · Группы и объявления · Ключи и ставки · Минус-фразы и площадки · Отчёты · Песочница · Агентства · Примеры JSON · Ошибки

Перейти в инструмент