Список групп объявлений
list_ad_groupsRetrieves ad groups filtered by campaign IDs or ad group IDs, requiring at least one selection criterion. Returns configurable fields and supports pagination.
Instructions
Возвращает список групп объявлений. Нужно передать campaignIds и/или ids — API Яндекс Директа требует хотя бы один критерий отбора. Запрос идёт в API v501 (в песочнице — в v5): группы Единой перформанс-кампании приходят с Type UNIFIED_AD_GROUP (v5 называет их TEXT_AD_GROUP; ответ v5 доступен через raw_request с apiVersion "v5").
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_ad_groups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Фильтр по id групп объявлений. | |
| limit | No | Максимум объектов на страницу. | |
| offset | No | Смещение постраничной выдачи (сколько объектов пропустить). | |
| fieldNames | No | Какие поля группы вернуть. | |
| campaignIds | No | Фильтр по id кампаний. | |
| autoPaginate | No | Забрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём). | |
| client_login | No | Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена. |