Это руководство предназначено для разработчиков, которые хотят использовать API AdMob для программного получения информации о своем аккаунте AdMob.
Все вызовы API Google AdMob должны быть авторизованы через OAuth2 , чтобы ваше приложение могло взаимодействовать с веб-службами от имени пользователя. OAuth2 позволяет вашему клиентскому приложению API AdMob получать доступ к учетной записи пользователя AdMob без необходимости обработки или хранения имени пользователя или пароля пользователя. Обзор авторизации см. в разделе Авторизация .
Выполните следующие шаги, чтобы сгенерировать учетные данные OAuth2 и сделать первый запрос.
Предварительные условия
Знакомство с основами REST и авторизацией запросов с помощью OAuth 2.0 .
Определите тип аутентификации
Проверьте таблицу ниже, чтобы узнать, какой тип аутентификации наиболее подходит для вашего приложения:
Выберите тип аутентификации OAuth2. | Если ... |
---|---|
Настольное приложение |
|
Веб-приложение |
|
Создать проект
Чтобы начать использовать API AdMob, вам необходимо сначала создать или выбрать проект в консоли API Google и включить API с помощью инструмента настройки , который проведет вас через весь процесс и автоматически активирует API AdMob.
Включение API для существующего проекта
Следующие шаги применимы к пользователям, у которых есть существующий проект и которые предпочитают активировать для него API AdMob вручную.
Чтобы включить API для вашего проекта:
- Open the API Library в Google API Console .
- If prompted, select a project, or create a new one. В API Library перечислены все доступные API, сгруппированные по семейству продуктов и популярности.
- Если API, который вы хотите включить, не отображается в списке, воспользуйтесь поиском, чтобы найти его, или нажмите « Просмотреть все» в семействе продуктов, к которому он принадлежит.
- Выберите API, который хотите включить, затем нажмите кнопку « Включить» .
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
Создайте учетные данные OAuth2.
Следующие инструкции помогут вам создать идентификатор клиента OAuth 2.0 для использования в процессе установки приложения .
- Go to the Credentials page.
Нажмите СОЗДАТЬ УЧЕТНЫЕ ДАННЫЕ > Идентификатор клиента OAuth .
Если вы ранее не настроили экран согласия OAuth для этого проекта, вам будет предложено сделать это сейчас. Нажмите НАСТРОЙКА ЭКРАНА СОГЛАСИЯ . Существует несколько способов настроить экран согласия на использование идентификатора клиента OAuth 2.0.
- Установите тип пользователя «Внешний» и статус публикации «Опубликовано» .
Или установите тип пользователя «Внешний» и статус публикации «Тестирование» , затем добавьте тестовых пользователей , выбрав «Добавить пользователей» , чтобы предоставить им доступ к использованию вашего идентификатора клиента OAuth 2.0.
См. дополнительную информацию о настройке экрана согласия OAuth .
В качестве типа приложения выберите «Настольное приложение» или «Веб-приложение» , дайте ему имя и нажмите «Создать» .
По завершении вам будет предоставлен идентификатор клиента OAuth 2.0 и секрет клиента, которые вы можете скачать в формате JSON и сохранить для дальнейшего использования.
Обратиться с просьбой
API AdMob построен на основе HTTP и JSON, поэтому любой стандартный HTTP-клиент может отправлять к нему запросы и анализировать ответы. Однако клиентские библиотеки Google API обеспечивают лучшую языковую интеграцию, повышенную безопасность и поддержку авторизованных запросов. Клиентские библиотеки доступны на нескольких языках программирования; используя их, вы можете избежать необходимости вручную настраивать HTTP-запросы и анализировать ответы.
Создав учетные данные OAuth 2.0 , вы готовы начать использовать API AdMob. Чтобы запросить доступ с помощью OAuth 2.0, вашему приложению также необходима информация об области действия:
Объем | Значение |
---|---|
https://www.googleapis.com/auth/admob.readonly | Просмотреть все данные AdMob. Сюда может входить информация об аккаунте, настройки инвентаря и медиации, отчеты и другие данные. Сюда не входят конфиденциальные данные, такие как платежи или сведения о кампании. |
https://www.googleapis.com/auth/admob.report | Просматривайте отчеты об эффективности рекламы и доходах. См. идентификатор издателя, часовой пояс и код валюты по умолчанию. |
Сделайте свой первый запрос на создание отчета, используя примеры на Java , PHP , Python или Curl .
Отозвать общие токены
Вы можете отозвать общие токены двумя способами:
Перейдите на страницу разрешений своей учетной записи Google и отзовите доступ к соответствующему проекту.
Кроме того, вы можете отозвать токены веб-приложения с помощью Google Identity API .