Создание приложения для API Яндекс.Метрики

Для использования API Яндекс.Метрики вам необходимо создать приложение и пройти авторизацию с помощью OAuth-токена. В этой статье разбирается первая часть подготовительных работ.

Для регистрации приложения подойдет обычная почта Яндекса. Если у вас уже есть аккаунт в Яндексе (например, на котором размещен ваш счетчик Яндекс.Метрики), вы можете использовать его.

Перейдите в раздел API Яндекс.Метрики прямо через интерфейс metrika.yandex.ru:

Раздел «API» в интерфейсе Яндекс.Метрики

На открывшейся вкладке нажмите на кнопку Получить OAuth-токен:

Получить OAuth-токен

Вас перенаправит на страницу с созданием приложения. Перейти в нее можно и по-другому. Авторизовавшись под своей учетной записью Яндекса, просто воспользуйтесь адресом https://oauth.yandex.ru/client/new

Окно создания приложения

Заполните необходимые поля (со звездочкой *):

  • Название сервиса
  • Платформа приложения
  • Доступ

В Название сервиса введите название приложения, которое будет использоваться. Вы можете задать произвольное имя. Например, YandexMetrika:

Название приложения

К приложению можно прикрепить иконку (максимальный размер не более 1Мб), но мы это делать не будем, поскольку данное приложение будет использоваться для личных целей, а не публично.

В Платформы приложения поставьте галочку рядом с Веб-сервисы, а затем в пустое поле Redirect URI поставьте курсор. Во всплывшей подсказке нажмите на ссылку Подставить URL для отладки:

Веб-сервисы — Подставить URL для отладки

В поле Redirect URI (URL, куда направим пользователя после того, как он разрешил или отказал приложению в доступе) автоматически подставится адрес https://oauth.yandex.ru/verification_code:

Подставить URL для отладки

В разделе Доступ к данным в поле Название доступа начните вводить слово Метрика:

Доступы к Яндекс.Метрике

В зависимости от того, какие задачи вы планируете в дальнейшем решать с помощью созданного приложения, выберите соответствующий доступ. Для Яндекс.Метрики их два:

  1. Получение статистики, чтение параметров своих и доверенных счётчиков (metrika:read)
  2. Создание счётчиков, изменение параметров своих и доверенных счётчиков (metrika:write)

Мы в блоге Ya Dashboard! будем публиковать материалы, преимущественно, для работы со статистикой Яндекс.Метрики, то есть использования API отчетов и Logs API. Поэтому при создании приложения выберем вариант Получение статистики, чтение параметров своих и доверенных счётчиков.

Получение статистики, чтение параметров своих и доверенных счётчиков

Далее укажите контактный адрес электронной почты, на который Яндекс будет присылать информацию, касающуюся изменений во внешней авторизации:

Почта для связи

В самом конце страницы нажмите на кнопку Создать приложение:

Создание приложения

Приложение будет создано. После этого вас автоматически перенаправит на другую страницу, где будут отображаться технические данные о вашем приложении:

Данные созданного приложения

Часть из этих данных вам понадобится через некоторое время при получении OAuth-токена.