Как получить API-токен Яндекс Директ: oauth-приложение и отдельная заявка в кабинете
Два окна доступа: приложение на личной почте и заявка в кабинете Директа. Одно приложение на много кабинетов, токен — после «одобрена».
Получить предложение
Два разных окна: oauth не равен заявке в Директе
Идентификаторы приложения и доступ к кабинету — не одна кнопка.
Запрос «как получить токен Яндекс Директ» обычно ведёт на общую страницу oauth. Для Директа этого мало. Сначала создают приложение. Затем в рекламном кабинете пишут отдельную заявку на полный API. Пока вторая не одобрена, ключ не откроет боевую статистику. Это не курс и не «яндекс oauth для Диска» — только доступ директолога к кабинетам.
Документация API Яндекс Директ описывает методы. Практика агентства начинается раньше: кто владеет приложением, какие скоупы стоят, куда прикрепить файл заявки. Настройки API в кабинете — про статусы заявки и баллы, не про Мастер отчётов.
Курсы «api яндекс директ» часто начинают с методов и обходят заявку в кабинете. В агентской практике наоборот: методы бесполезны, пока заявка не одобрена и пока одно приложение не повешено на нужные логины. Не начинайте с кода. Начните с почты, скоупов и статуса в «Моих заявках».
Как создать приложение и какие скоупы поставить
Тип «для доступа к API или отладке». Client ID и Secret сразу в закрытое место.
Тип приложения — доступ к API или отладка. Название может быть служебным. Почта — личная, техническая. Скоупы: использование API Директа и чтение статистики Метрики. В поиске доступов набирайте metrika латиницей.
После сохранения сразу копируют Client ID и Client Secret. В эфире приложение заново не создавали, чтобы секрет не попал на запись. Почту с учебных экранов и шуточные названия юрлиц в текст не переносим.
Куда писать заявку и какой файл приложить
Только кабинет Директа. Описание — выгрузка статистики, не ставки.
Второе окно — раздел заявок API внутри Яндекс Директа. Там выбирают уже созданное приложение и пишут, зачем доступ: автоматизация отчётности, еженедельные PDF, без управления ставками. Файл обязателен: в демо грузили что угодно, хоть заглушку. Без файла заявка не уходит.
- Открыть кабинет Директа под логином, который владеет приложением.
- Найти список заявок API и создать новую — не возвращаться на oauth.yandex.ru.
- Выбрать своё приложение из списка, не чужой Client ID.
- Описать выгрузку статистики и отчёты, явно отказаться от управления ставками.
- Приложить файл-заглушку и отправить.
- Следить за статусом в «Моих заявках», не в почте oauth.
Сколько ждать и зачем песочница
Формально до недели, у спикеров часто минуты.
Слайд показывает вилку статусов: на рассмотрении, одобрена, отклонена. Срок на слайдах — до семи дней. Голос Романа: самое долгое рассмотрение у него было около пятнадцати минут. В регламент агентства лучше закладывать неделю и не обещать клиенту «токен сегодня к обеду».
Пока заявка висит, агенту отдают песочницу. Боевой кабинет с живым бюджетом — после статуса «одобрена». Баллы API версии 4 конечны: в учебном кадре была крупная цифра, её не нормируем. Важно другое — контур не должен жечь баллы холостыми опросами.
Одно приложение на много кабинетов
Не пятьдесят приложений на пятьдесят логинов.
Новички плодят приложение на каждый клиентский логин. В эфире наоборот: одно приложение, много кабинетов. Нужно расшарить доступ логину приложения. У AdPump так снимают статистику с десятков аккаунтов. Это про API Яндекс Директ для агентства, не про мобильное приложение и не про рекламу приложений.
| Ошибка | Почему ломается | Как чинить |
|---|---|---|
| Приложение на клиентском логине | Клиент ушёл — потеряли контур | Личная техническая почта |
| Искать «метрика» по-русски | Скоуп не находится | Писать metrika латиницей |
| Токен до статуса «одобрена» | Боевые методы закрыты | Ждать заявку в кабинете |
| Представительский счётчик Метрики | Чтение статистики пустое | Прямой доступ или новое приложение |
Как забрать токен после «одобрена»
Authorize + свой Client ID. Дальше — снимок и отчёты, не журнал UI.
Когда заявка одобрена, открывают ссылку authorize и подставляют Client ID. Полученный токен кладут в закрытый файл окружения. Дальше контур может снимать статистику. Журнал «История изменений» из интерфейса всё равно не приедет — это отдельная тема про свой снимок. Сборка PDF по понедельникам — ИИ-отчёты и расписание. Порог «уже пора» — полуручной режим. Обзор эфира — страница разбора.
После выдачи токена его не кладут в чат «на всякий» и не дублируют в пяти таблицах. Один закрытый файл окружения, один список людей, кто его видит. Смена сотрудника — перевыпуск, не пересылка старого ключа. Яндекс Директ API ключ в переписке с клиентом не нужен: клиенту нужен PDF, не секрет приложения.
Как получить токен Яндекс Метрики отдельно обычно не требуется: в эфире часто дублируют тот же ключ, если скоуп чтения уже стоит. Ломается схема, когда счётчик выдан через представителя: чтение статистики пустое, хотя API Директа отвечает. Тогда либо прячут счётчик на прямой доступ, либо собирают новое приложение на свежем аккаунте — чинить старое «ещё одним скоупом» часто бесполезно.
Oauth-токен Яндекса в общих гайдах часто про Диск и Музыку. Здесь authorize нужен только затем, чтобы Директ отдал доступ после своей заявки. Если открыли authorize до статуса «одобрена», получите ключ, который не откроет боевые методы — и будете час искать ошибку в коде, хотя ошибка в статусе заявки.
Получить токен Яндекс oauth в общих гайдах — отдельная бытовая история про почту и сервисы Яндекса. Директологу достаточно помнить: oauth-приложение здесь служебное, заявка — в кабинете, токен — после «одобрена». Дальше ключ живёт рядом с токеном бота в одном закрытом файле, а не в пяти разных таблицах команды.
Частые вопросы
Практика доступа к API Яндекс Директ: два окна, скоупы, срок, одно приложение.
Почему нельзя обойтись одной страницей oauth.yandex.ru?
Там создают приложение и получают идентификаторы. Полный доступ к рекламному кабинету открывает вторая заявка внутри Яндекс Директа. Путать эти окна — самая частая дыра.
На чьей почте регистрировать приложение?
На личной почте Яндекса технического человека, не на клиентском логине. Клиентские кабинеты потом расшаривают на этот логин. Одно приложение обслуживает много аккаунтов.
Какие скоупы ставить и как найти Метрику?
API Директа плюс чтение статистики Метрики. В поиске пишите metrika латиницей — русское «метрика» пункт часто не находит. Без Метрики в отчёте не будет отказов и глубины.
Сколько ждать одобрения заявки?
На слайдах — до семи дней. У спикеров часто около пятнадцати минут. Планируйте неделю, радуйтесь минутам. Пока ждёте, крутите песочницу, не боевой кабинет.
Нужны ли Госуслуги в 2026 году?
Спикеры не фиксируют это как правило. Костя оговаривается, что может ошибаться. В старом приложении 2015 года Госуслуги просили, когда добавляли много скоупов. Не ставьте это жёстким условием в регламент.
Когда забирать токен?
Только после статуса «одобрена». Ссылка authorize плюс ваш Client ID. Статусы «новая» и «на рассмотрении» боевой токен не дают.
Почему представительский доступ ломает Метрику?
Скоуп чтения Метрики не видит счётчики, выданные через представителя. На старом приложении пункт скоупа может не появиться — пробуют новый аккаунт или новое приложение.
Нужен рабочий доступ к API кабинетов, а не «ещё один ключ с форума»?
Поможем выстроить технический логин, заявку в Директе и аккуратный съём статистики — без управления ставками и без путаницы с Диском.
