Клиентская библиотека для 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.0.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.
Как настроить приложение
В руководстве по расширенному использованию приведены рекомендации по настройке времени ожидания, параметров повторных попыток, задержки запуска и управления зависимостями.