Сводка по клиентам
clients_overviewGet a one-call overview of managed Yandex Direct client accounts: balances, campaign counts by state and moderation, and optional impressions, clicks, and spend by period.
Instructions
Сводка по всем клиентам агентства и кабинетам в управлении за один вызов — для вопросов вроде «что у меня по аккаунтам в управлении»: по каждому клиенту баланс общего счёта и число кампаний по состояниям (on — идут или могут идти, suspended — остановлены пользователем, off — не идут по другой причине, ended) и статусам модерации (moderation, rejected, draft). Архивные кампании не считаются. Клиенты — из list_clients, либо явный список logins. Ошибка по одному клиенту (нет доступа, нет общего счёта) не прерывает остальных и попадает в его строку. С параметром stats добавляет показы, клики и расход (с НДС, в валюте клиента) за период — по одному отчёту Reports на клиента, строго по очереди: Яндекс пускает примерно один отчёт в 10 секунд, так что 30 клиентов — около 5 минут; клиенты без неархивных кампаний не запрашиваются, а кто не уложился в 5 минут, помечается statsSkipped. Без stats ответ приходит за секунды — запрашивать расход, только когда вопрос про деньги или трафик. Не вызывать list_campaigns по каждому клиенту в цикле — эта сводка дешевле. Тратит баллы API каждого клиента: один запрос кампаний на клиента и один запрос баланса на 50 клиентов у агентства (у обычного аккаунта — на каждого). Кампании клиентов читаются через API v501, в песочнице — через 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": "clients_overview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Сколько клиентов обойти, 1–200. По умолчанию 50. | |
| stats | No | Добавить показы, клики и расход за этот период. Медленно: около 10 с на клиента. | |
| logins | No | Только эти логины клиентов. По умолчанию — все из list_clients. | |
| search | No | Только клиенты, у которых логин или название содержит эту подстроку. |