Все запросы, отправляемые приложением в AdMob API, должны содержать токен авторизации. который одновременно является идентификатором этого приложения для Google.
Протоколы авторизации
Для авторизации запросов ваше приложение должно использовать протокол OAuth 2.0. Другие протоколы авторизации не поддерживаются. Если в вашем приложении используется вход с аккаунтом Google, некоторые действия в рамках авторизации выполняются автоматически.
Авторизация запросов с помощью протокола OAuth 2.0
Для всех запросов к AdMob API требуется авторизация от пользователя, прошедшего аутентификацию.
Этот процесс выполняется с помощью идентификатора клиента OAuth.
Как получить идентификатор клиента OAuthКлюч также можно создать на странице Учетные данные.
Особенности процесса авторизации с помощью OAuth 2.0 зависят от типа приложения. В общих чертах процедура выглядит так:
- Когда приложению потребуются пользовательские данные, оно запрашивает у Google определенную область доступа.
- Google показывает пользователю окно запроса доступа с предложением авторизовать приложение для запроса этих данных.
- Если пользователь соглашается, Google предоставляет приложению токен доступа с коротким сроком действия.
- Ваше приложение запрашивает пользовательские данные, указывая токен доступа.
- Получив действительный запрос и токен, Google отправляет необходимые данные.
Иногда процесс может включать дополнительные этапы, например использование токенов обновления для получения новых токенов доступа. Подробную информацию о процедуре для приложений различных типов можно найти в документации по OAuth 2.0.
Информация об области действия OAuth 2.0 для AdMob API:
| Область действия | Значение |
|---|---|
https://www.googleapis.com/auth/admob.readonly |
Просматривать все данные AdMob. К таким сведениям относится информация об аккаунте, настройках инвентаря и медиации, отчетах и другие данные. Сюда не входят конфиденциальные данные, например информация о платежах и кампаниях. |
https://www.googleapis.com/auth/admob.report |
Просматривать отчеты об эффективности объявлений и доходах. Идентификатор издателя, часовой пояс и код валюты по умолчанию. |
Чтобы запросить доступ по протоколу OAuth 2.0, приложению нужна информация об области доступа, а также данные, которые Google предоставляет при регистрации приложения (например, идентификатор или секретный ключ клиента).
Совет. Клиентские библиотеки API Google автоматически выполняют часть задач, связанных с авторизацией. Они доступны для разных языков программирования. Ознакомьтесь с дополнительными материалами.