Начало работы с AdMob API

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

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

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

Требования

Как определить тип аутентификации

В таблице ниже указано, какой тип аутентификации лучше всего подходит для вашего приложения.

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

Как создать проект

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

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

Ниже описаны действия для пользователей, у которых уже есть проект и которые хотят активировать AdMob API вручную.

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

  1. Откройте библиотеку API в Google API Console.
  2. Выберите существующий проект или создайте новый. В библиотеке API перечислены все доступные API, сгруппированные по семействам продуктов и популярности.
  3. Если нужного API нет в списке, найдите его с помощью поиска или нажмите Показать все в семействе продуктов, к которому он относится.
  4. Выберите API, который хотите включить, и нажмите кнопку Включить.
  5. Если появится запрос, включите оплату.
  6. При необходимости прочтите и примите Условия использования API.

Как создать учетные данные OAuth2

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

  1. Перейдите на страницу клиентов.

  2. Нажмите Создать учетные данные > Идентификатор клиента OAuth.

    Если вы не настраивали окно запроса доступа OAuth для этого проекта ранее, вам будет предложено сделать это сейчас. Нажмите Настроить экран запроса согласия. Настроить окно запроса доступа с использованием идентификатора клиента OAuth 2.0 можно несколькими способами.

    1. Установите тип пользователя Внешний и статус публикации Опубликовано.

    2. Или задайте для типа пользователя значение Внешний, а для статуса публикации – Тестирование, а затем добавьте тестировщиков, нажав Добавить пользователей, чтобы предоставить им доступ к идентификатору клиента OAuth 2.0.

      Подробнее о том, как настроить окно запроса доступа OAuth…

  3. Выберите тип приложения Desktop app (Приложение для ПК) или Web Application (Веб-приложение), задайте название и нажмите Create (Создать).

После этого вы увидите идентификатор и секретный код клиента OAuth 2.0, которые можно скачать в формате JSON и сохранить для дальнейшего использования.

Отправить запрос

AdMob API использует технологии HTTP и JSON, поэтому для отправки запросов и обработки ответов подходит любой стандартный HTTP-клиент. Однако клиентские библиотеки API Google обеспечивают более высокий уровень безопасности, поддержку запросов, требующих авторизации, и более эффективную интеграцию языков. С клиентскими библиотеками вам больше не придется вручную настраивать HTTP-запросы и интерпретировать ответы.

После того как вы создадите учетные данные OAuth 2.0, вы сможете начать использовать AdMob API. Чтобы запросить доступ по протоколу 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.