Авторизация

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

Пример запроса:

GET v1/management/advertiser/<advertiserId>/campaign/<campaignId> HTTP/1.1
Host: api.media.metrika.yandex.net
Authorization: OAuth <access_token>
Content-Type: application/x-yametrika+json
Content-Length: 127

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

Примечание

Обеспечьте безопасное хранение авторизационного токена, не передавайте его третьим лицам.

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

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

  1. Создайте приложение, при этом заполните поля:

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

    • иконка сервиса — необязательно;

    • платформы приложения — выберите веб-сервисы;

    • redirect URI — укажите https://oauth.yandex.ru/verification_code;

    • доступ к данным — укажите mediametrika:read и mediametrika:write.

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

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

    https://oauth.yandex.ru/authorize?response_type=token&client_id=<идентификатор приложения>

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

Предыдущая
API Метрики для медийной рекламы
Следующая
API отчетов