Начните работу с AdMob API

Это руководство предназначено для разработчиков, которые хотят использовать API AdMob для программного получения информации о своем аккаунте AdMob.

Все вызовы API Google AdMob должны быть авторизованы через OAuth2 , чтобы ваше приложение могло взаимодействовать с веб-службами от имени пользователя. OAuth2 позволяет вашему клиентскому приложению API AdMob получать доступ к учетной записи пользователя AdMob без необходимости обработки или хранения имени пользователя или пароля пользователя. Обзор авторизации см. в разделе Авторизация .

Выполните следующие шаги, чтобы сгенерировать учетные данные OAuth2 и сделать первый запрос.

Предварительные условия

Определите тип аутентификации

Проверьте таблицу ниже, чтобы узнать, какой тип аутентификации наиболее подходит для вашего приложения:

Выберите тип аутентификации OAuth2. Если ...
Настольное приложение
  • Вы управляете всеми своими аккаунтами AdMob API с помощью одного управляющего аккаунта верхнего уровня.
  • Вы впервые пользуетесь программой или хотите быстро начать работу с простейшей настройкой.
  • Ваше приложение проверяет подлинность пользователей Google AdMob только с одного компьютера.
Веб-приложение
  • Вы хотите пройти аутентификацию как пользователь, который может предоставить вашему приложению разрешение на доступ к данным своего аккаунта API AdMob.
  • Вы хотите легко создавать несколько учетных данных для авторизации, например, для управления сторонними учетными записями.
  • Вашему приложению требуются URL-адреса обратного вызова. URL-адреса обратного вызова не поддерживаются в потоке настольного приложения.

Создать проект

Чтобы начать использовать API AdMob, вам необходимо сначала создать или выбрать проект в консоли API Google и включить API с помощью инструмента настройки , который проведет вас через весь процесс и автоматически активирует API AdMob.

Включение API для существующего проекта

Следующие шаги применимы к пользователям, у которых есть существующий проект и которые предпочитают активировать для него API AdMob вручную.

Чтобы включить API для вашего проекта:

  1. Open the API Library в Google API Console .
  2. If prompted, select a project, or create a new one. В API Library перечислены все доступные API, сгруппированные по семейству продуктов и популярности.
  3. Если API, который вы хотите включить, не отображается в списке, воспользуйтесь поиском, чтобы найти его, или нажмите « Просмотреть все» в семействе продуктов, к которому он принадлежит.
  4. Выберите API, который хотите включить, затем нажмите кнопку « Включить» .
  5. If prompted, enable billing.
  6. If prompted, read and accept the API's Terms of Service.

Создайте учетные данные OAuth2.

Следующие инструкции помогут вам создать идентификатор клиента OAuth 2.0 для использования в процессе установки приложения .

  1. Go to the Credentials page.
  2. Нажмите СОЗДАТЬ УЧЕТНЫЕ ДАННЫЕ > Идентификатор клиента OAuth .

    Если вы ранее не настроили экран согласия OAuth для этого проекта, вам будет предложено сделать это сейчас. Нажмите НАСТРОЙКА ЭКРАНА СОГЛАСИЯ . Существует несколько способов настроить экран согласия на использование идентификатора клиента OAuth 2.0.

    1. Установите тип пользователя «Внешний» и статус публикации «Опубликовано» .
    2. Или установите тип пользователя «Внешний» и статус публикации «Тестирование» , затем добавьте тестовых пользователей , выбрав «Добавить пользователей» , чтобы предоставить им доступ к использованию вашего идентификатора клиента OAuth 2.0.

      См. дополнительную информацию о настройке экрана согласия OAuth .

  3. В качестве типа приложения выберите «Настольное приложение» или «Веб-приложение» , дайте ему имя и нажмите «Создать» .

По завершении вам будет предоставлен идентификатор клиента 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 .

Отозвать общие токены

Вы можете отозвать общие токены двумя способами:

  1. Перейдите на страницу разрешений своей учетной записи Google и отзовите доступ к соответствующему проекту.

  2. Кроме того, вы можете отозвать токены веб-приложения с помощью Google Identity API .