Авторизация
Для использования 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-токена
Внимание. Если вы работаете с API Метрики непосредственно из браузера, воспользуйтесь инструкцией.
Чтобы получить авторизационный токен:
- Создайте приложение, при этом заполните поля:
- название — можно указать произвольно;
- иконка сервиса — необязательно;
- платформы приложения — выберите веб-сервисы;
- redirect URI — укажите https://oauth.yandex.ru/verification_code;
доступ к данным — укажите набор доступов для вашего приложения. Какие бывают доступы:
- metrika:read — получение статистики, чтение параметров своих и доверенных счетчиков, получение списка счетчиков;
- metrika:write — создание счетчиков, изменение параметров своих и доверенных счетчиков, загрузка любых данных;
- metrika:expenses — загрузка в счетчики расходов;
- metrika:user_params — загрузка в счетчики параметров пользователей;
- metrika:offline_data — загрузка в счетчики офлайн-данных (данные из CRM, офлайн-конверсии, звонки).
Примечание. Доступы metrika:expenses, metrika:user_params, metrika:offline_data не обязательны, если используется доступ metrika:write.
- Нажмите Создать приложение и скопируйте его ClientID (напротив идентификатора нажмите значок ).
- Добавьте скопированный ClientID в ссылку вида
https://oauth.yandex.ru/authorize?response_type=token&client_id=<идентификатор приложения>
- Перейдите по ссылке и на открывшейся странице скопируйте ваш авторизационный токен.