Список объявлений
list_adsRetrieves Yandex Direct ads by campaign, ad group, or ad IDs, with state/status filters, pagination, and selectable fields, including responsive ad details.
Instructions
Возвращает список объявлений. Нужно передать campaignIds, adGroupIds или ids — API Яндекс Директа требует хотя бы один из них; states и statuses только сужают выборку. Текстовые объявления Единой перформанс-кампании Директ хранит комбинаторными и отдаёт в одном из двух видов. Без responsiveAdFieldNames — в виде совместимости: Type TEXT_AD, запрошенные тексты в объекте TextAd. Если передано хотя бы одно поле в responsiveAdFieldNames — как Type RESPONSIVE_AD с объектом ResponsiveAd вместо TextAd, где заголовки и тексты — массивы Titles[] и Texts[] со статусом модерации каждого варианта.
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_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Фильтр по id объявлений. Длинный id (приходит в ответах строкой) передавать строкой как есть. | |
| limit | No | Максимум объектов на страницу. | |
| offset | No | Смещение постраничной выдачи (сколько объектов пропустить). | |
| states | No | Фильтр по состояниям объявлений. | |
| statuses | No | Фильтр по статусам модерации. | |
| adGroupIds | No | Фильтр по id групп объявлений. | |
| fieldNames | No | Какие поля объявления вернуть; без параметра — Id, AdGroupId, CampaignId, Status, State, Type. Тексты и ссылки (Title, Title2, Text, Href, …) приходят в объекте TextAd. Если переданы только они, в запрос добавляется Id: API не принимает пустой список полей объявления. | |
| campaignIds | No | Фильтр по id кампаний. | |
| autoPaginate | No | Забрать все страницы, идя по LimitedBy (limit тогда не ограничивает общий объём). | |
| client_login | No | Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена. | |
| responsiveAdFieldNames | No | Поля комбинаторного объявления (ResponsiveAdFieldNames API, передаются как есть). Хотя бы одно поле переключает ответ для комбинаторных объявлений на Type RESPONSIVE_AD с объектом ResponsiveAd вместо TextAd. Цены в PriceExtension (Price, OldPrice) приходят как в API — в микроединицах (× 1 000 000) валюты PriceCurrency, без пересчёта. |