Авторизация

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

GET /management/v1/counters HTTP/1.1
Host: api-metrika.yandex.net
Authorization: OAuth 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037
Content-Type: application/x-yametrika+json
Content-Length: 123

Если метод API вызван без токена или в запросе передан недействительный токен, сервер возвращает HTTP-статус 401 Unauthorized.

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

Чтобы получить авторизационный токен:

1. Создайте приложение и выберите пункт Для доступа к API или отладки.

2. Заполните поля:

   • название — можно указать произвольно;

   • почта — укажите предпочтительную почту для связи;

   • доступ к данным — укажите набор доступов для вашего приложения.

     Какие бывают доступы:

     • metrika:read — получение статистики, чтение параметров своих и доверенных счетчиков, получение списка счетчиков;
     • metrika:write — создание счетчиков, изменение параметров своих и доверенных счетчиков, загрузка любых данных;
     • metrika:expenses — загрузка в счетчики расходов;
     • metrika:user_params — загрузка в счетчики параметров пользователей;
     • metrika:offline_data — загрузка в счетчики офлайн-данных (данные из CRM, офлайн-конверсии, звонки).

     Доступы metrika:expenses, metrika:user_params, metrika:offline_data не обязательны, если используется доступ metrika:write.

   Примечание

   Если вы работаете через porg-логины (логины организации), то в правах доступа добавьте passport:business — это необходимо для выдачи токена от организации.

3. Нажмите Создать приложение и скопируйте его ClientID (напротив идентификатора нажмите значок ).

4. Добавьте скопированный ClientID в ссылку вида

   https://oauth.yandex.ru/authorize?response_type=token&client_id=<application_id>
   

5. Перейдите по ссылке и на открывшейся странице скопируйте ваш авторизационный токен.

Возможные проблемы и их решение