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

Это руководство предназначено для разработчиков, которые хотят использовать 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 вручную.

To enable an API for your project:

  1. Open the API Library in the Google API Console.
  2. If prompted, select a project, or create a new one. The API Library lists all available APIs, grouped by product family and popularity.
  3. If the API you want to enable isn't visible in the list, use search to find it, or click View All in the product family it belongs to.
  4. Select the API you want to enable, then click the Enable button.
  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 .