Клиентская библиотека для Java размещена на GitHub и распространяется через Maven Central . Она предлагает ряд функций, которые помогут вам использовать API, включая упрощенное управление учетными данными и создание клиентов для сервиса Google Ads API.
Для работы библиотеки требуется Java 8 или более поздняя версия.
Установка
Используйте спецификацию зависимостей (BOM) Google Ads API в файле 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>46.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.
: Начало работы с клиентской библиотекой Java
Для использования API Google Ads необходимо выполнить несколько шагов, чтобы получить доступ к API и настроить свои аккаунты Google Ads. Следуйте краткому руководству , которое шаг за шагом описывает все важные этапы, включая настройку аккаунтов Google Ads.
Основное использование
Чтобы узнать, как настроить проект, создать экземпляры клиентских сервисов и запустить примеры кода с помощью клиентской библиотеки Java, обратитесь к базовому руководству по использованию .
Аутентификация и авторизация
Клиентская библиотека Java поддерживает несколько подходов к аутентификации и авторизации, включая потоки OAuth 2.0 для настольных и веб-приложений, учетные записи служб и учетные данные приложения по умолчанию. Для получения дополнительной информации обратитесь к руководству по аутентификации и авторизации .
Настройка и ведение журналов
Клиентская библиотека Java поддерживает множество параметров конфигурации (включая файлы ads.properties , переменные среды и программную конфигурацию), а также возможности логирования для отслеживания запросов и ответов API.
Коммунальные услуги
Клиентская библиотека Java включает в себя вспомогательные классы для повышения удобства использования API. Для получения дополнительной информации обратитесь к следующим руководствам:
- FieldMasks : Вспомогательные функции для построения и вычисления масок полей обновления.
- ResourceNames : Утилиты для форматирования строковых имен ресурсов сущностей.
- Длительные операции : Вспомогательные средства для мониторинга и управления асинхронными операциями API.
Доработайте свое приложение
Для получения рекомендаций по тонкой настройке тайм-аутов, параметров повторных попыток, задержки запуска и управления зависимостями вашего приложения обратитесь к руководству по расширенному использованию .