Регистрация приложения
Процедура регистрации выполняется разработчиком приложения и включает два этапа:
Регистрация на сервисе Яндекс ID
Откройте страницу Создание приложения и выберите пункт Для доступа к API или отладки. Заполните поля:
-
Название вашего сервиса — можно указать произвольно;
-
Почта для связи — укажите предпочтительную почту для связи;
-
Доступ к данным — добавьте источник данных для управления рекламой:
-
Работа с организациями Яндекс ID (passport:business), чтобы получить доступ к авторизации от имени организации в ID.
-
Использование API Яндекс Директа (direct:api), чтобы получить доступ к управлению рекламными материалами.
Можно ввести часть названия, затем выбрать подходящее из предложенного списка.
-
Нажмите Создать приложение. В результате регистрации Яндекс ID сгенерирует и отобразит на странице ClientID и Client secret. ClientID необходимо указать при создании заявки на доступ к API. ClientID и Client secret необходимы для получения авторизационного токена, разрешающего приложению доступ к данным конкретного пользователя.
Список зарегистрированных вами приложений доступен на странице https://oauth.yandex.ru/. Вы можете узнать ClientID и Client secret, изменить параметры приложения, а также удалить приложение.
Создание заявки на доступ к API
-
Войдите на Яндекс под логином разработчика приложения.
-
Перейдите на вкладку Мои заявки на странице Настройки API.
Внимание
Чтобы получить доступ к странице настроек API, необходимо создать хотя бы одну кампанию в веб-интерфейсе Директа.
При первом посещении страницы настроек API необходимо принять пользовательское соглашение.
-
Нажмите кнопку Новая заявка. В появившемся меню выберите тип заявки:
- “Полный доступ” — заявка на полный доступ к API Директа, включающий как возможность управлять реальными кампаниями клиентов, так и доступ к Песочнице.
- “Тестовый доступ” — заявка на ограниченный доступ к API Директа, включающий только доступ к Песочнице, достаточный для разработки и отладки приложения. В дальнейшем заявку на ограниченный доступ можно будет преобразовать в заявку на полный доступ.
-
В форме создания заявки:
- Выберите из списка ClientID, полученный при регистрации на сервисе Яндекс ID.
- Укажите корректный и актуальный адрес электронной почты.
- В остальных полях укажите максимально точные и полные сведения о приложении.
- Подтвердите свое согласие с пользовательским соглашением.
Нажмите кнопку Отправить.
Срок рассмотрения заявки — до 7 дней. Рассмотренная заявка получит статус “одобрена” или “отклонена”.
Список созданных вами заявок на регистрацию приложения доступен на вкладке Мои заявки страницы Настройки API. Вы можете отслеживать статус рассмотрения заявок, в случае отклонения заявки — ознакомиться с причинами отклонения, редактировать и удалять заявки, а также преобразовать заявку на ограниченный доступ в заявку на полный доступ.
Изменение заявки на доступ к API
Внимание
Необходимо поддерживать достоверность и актуальность сведений, указанных в заявке на доступ к API. Если данные изменились (например, изменился адрес электронной почты разработчика приложения или существенно увеличилось количество используемых экземпляров приложения), отредактируйте заявку.
Перейти к редактированию заявки можно на вкладке Мои заявки страницы Настройки API. После внесения изменений в заявку она будет отправлена на повторное рассмотрение. До момента одобрения новой версии заявки будут действовать параметры, указанные в предыдущей заявке.