Основной принцип использования клиентской библиотеки Java выглядит следующим образом:
Создайте новый проект Maven или Gradle.
Создайте новый проект Maven или Gradle в выбранной вами IDE. Полученные артефакты будут опубликованы в репозитории Maven Central .
Используйте спецификацию компонентов (BOM) Google Ads API для управления версиями зависимостей.
Чтобы запустить предварительно подготовленные примеры кода, включенные в модуль google-ads-examples , клонируйте репозиторий google-ads-java с GitHub или соберите проект из исходного кода . При сборке из исходного кода убедитесь, что в вашей IDE включена обработка аннотаций.
Настройка доступа к API
Для подключения к API Google Ads необходимо предоставить учетные данные для аутентификации и авторизации. Подробную информацию о необходимых учетных данных и настройке клиентской библиотеки см. в руководстве по аутентификации и авторизации .
Сделайте свой первый звонок
После настройки учетных данных вы готовы совершить свой первый вызов API.
Чтобы подтвердить свои учетные данные и совершить первый вызов, используя клонированный репозиторий google-ads-java , запустите пример GetCampaigns .
Для начала перейдите в каталог google-ads-examples :
cd google-ads-examples
В этом примере требуется параметр --customerId , значением которого является идентификатор клиента вашего аккаунта Google Ads без дефисов ( - ).
Для запуска с помощью Gradle:
./gradlew -q runExample \
--example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Для запуска с помощью Maven:
mvn exec:java \
-Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
-Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"
Изучите другие примеры.
Пакет examples в google-ads-examples содержит несколько полезных примеров. Большинство примеров требуют параметров. Вы можете либо передать параметры в качестве аргументов (рекомендуется), либо отредактировать значения-заполнители INSERT_..._HERE в исходном коде. Чтобы увидеть описание использования примера, передайте --help в качестве единственного аргумента.
С помощью Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --help"
В Gradle также можно использовать задачу listExamples для вывода списка всех примеров, примеров в подкаталоге или примеров, в описании которых содержится поисковый запрос:
# List all examples:
./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
./gradlew -q listExamples --searchTerm='Performance Max'