Клиентская библиотека для Java размещена на GitHub и распространяется через Maven Central. Она предлагает несколько функций, которые помогут вам использовать API, включая более простое управление учетными данными и создание клиентов сервиса Google Ads API.
Для работы библиотеки требуется Java 8 или более поздней версии.
Установка
Чтобы управлять версиями зависимостей, используйте Google Ads API Bill of Materials (BOM) в файле pom.xml или build.gradle.
<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
versions of all google-ads libraries. -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads-bom</artifactId>
<version>48.1.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Add the google-ads dependency, without a version. The version is
managed by the BOM. -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
</dependency>
Вы также можете собрать библиотеку из исходного кода.
Выполнение первого вызова API
Чтобы использовать Google Ads API, вам нужно выполнить несколько шагов для получения доступа к API и настроить аккаунты Google Рекламы. Следуйте краткому руководству, в котором описаны все важные шаги, включая настройку аккаунтов Google Рекламы.
Как пользоваться отчетом
В руководстве по базовому использованию рассказывается, как настроить проект, создать экземпляры клиентов сервиса и запустить примеры кода с клиентской библиотекой Java.
Аутентификация и авторизация
Клиентская библиотека Java поддерживает несколько подходов к аутентификации и авторизации, включая процессы OAuth 2.0 для настольных и веб-приложений, сервисные аккаунты и Application Default Credentials. Подробную информацию вы найдете в руководстве по аутентификации и авторизации.
Настройка и ведение журнала
Клиентская библиотека Java поддерживает несколько вариантов конфигурации (в том числе файлы ads.properties, переменные среды и программную конфигурацию) и возможности ведения журнала для отслеживания запросов и ответов API.
Утилиты
Клиентская библиотека Java включает служебные классы, которые упрощают работу с API. Дополнительную информацию можно найти в следующих руководствах:
- FieldMasks – вспомогательные средства для создания и расчета масок полей обновления.
- ResourceNames – утилиты для форматирования строк названий ресурсов объектов.
- Продолжительные операции. Вспомогательные инструменты для отслеживания асинхронных операций API и управления ими.
Как настроить приложение
В руководстве по расширенному использованию вы найдете рекомендации по настройке времени ожидания, повторных попыток, задержки при запуске и управления зависимостями.