Список кампаний
list_campaignsRetrieves Yandex Direct campaigns with optional filters for IDs, types, states, and moderation statuses, and can include bidding strategies and key goals for campaign analysis.
Instructions
Возвращает список кампаний с необязательными фильтрами по id, типу, состоянию и статусу. Запрос идёт в API v501 (в песочнице — в v5): только он отдаёт Единую перформанс-кампанию с типом UNIFIED_CAMPAIGN (v5 называет её TEXT_CAMPAIGN; ответ v5 доступен через raw_request с apiVersion "v5"). Денежные поля (Funds общего счёта — Sum, Balance, SumAvailableForTransfer, Spend) отдаются в валюте аккаунта. Бюджет кампании — недельный (WeeklySpendLimit) и у ручных ставок, и у автостратегий; он лежит внутри BiddingStrategy и виден только при strategy: true (дневного бюджета DailyBudget у API больше нет). strategy: true добавляет блок TextCampaign/UnifiedCampaign со стратегией (BiddingStrategy), ключевыми целями (PriorityGoals), счётчиками Метрики, моделью атрибуции, пакетной стратегией и переносом бюджета (WeeklyBudgetRollover — сколько добавлено к недельному бюджету за счёт неиспользованного на прошлой неделе, до 30%; null — перенос не применяется или данных нет) — деньги в нём тоже в валюте аккаунта, а сам объект BiddingStrategy в этом виде принимает set_campaign_strategy.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_campaigns"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Фильтр по id кампаний. | |
| limit | No | Максимум объектов на страницу. | |
| types | No | Фильтр по типам кампаний. | |
| offset | No | Смещение постраничной выдачи (сколько объектов пропустить). | |
| states | No | Фильтр по состояниям кампаний. | |
| statuses | No | Фильтр по статусам модерации. | |
| strategy | No | Вернуть стратегию показа и ключевые цели (блок TextCampaign или UnifiedCampaign). | |
| fieldNames | No | Какие поля кампании вернуть. Стратегия здесь не запрашивается — для неё strategy: true. | |
| autoPaginate | No | Забрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём). | |
| client_login | No | Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена. |