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

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

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

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

Предпосылки

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

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

Выберите тип аутентификации OAuth2 Если ...
Приложение для ПК
  • Вы управляете всеми своими аккаунтами API AdMob, используя единую учетную запись менеджера верхнего уровня.
  • Вы новичок или хотите быстро приступить к работе с помощью простейшей настройки.
  • Ваше приложение аутентифицирует пользователей 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. The 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-клиент может отправлять запросы и анализировать ответы. Однако клиентские библиотеки API Google обеспечивают лучшую языковую интеграцию, повышенную безопасность и поддержку авторизованных запросов. Клиентские библиотеки доступны на нескольких языках программирования; их использование позволяет избежать необходимости вручную настраивать 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. Кроме того, вы можете отозвать токены веб-приложений с помощью API Google Identity .