Ниже описаны основные принципы работы с клиентской библиотекой Java.
Создайте проект Maven или Gradle.
Создайте новый проект Maven или Gradle в выбранной вами IDE. Артефакты публикуются в центральном хранилище Maven.
Для управления версиями зависимостей используйте Google Ads API Bill of Materials (BOM).
Если вы хотите запустить готовые примеры кода, включенные в модуль google-ads-examples, клонируйте хранилище google-ads-java из GitHub или соберите из исходного кода. Если вы собираете код из источника, убедитесь, что в вашей IDE включена обработка аннотаций.
Настроить доступ к API
Чтобы подключиться к Google Ads API, необходимо предоставить учетные данные для аутентификации и авторизации. Подробную информацию о необходимых учетных данных и настройке клиентской библиотеки можно найти в руководстве по аутентификации и авторизации.
Сделайте первый звонок
После настройки учетных данных вы можете выполнить первый вызов API.
Чтобы проверить учетные данные и выполнить первый вызов с помощью клонированного репозитория google-ads-java, запустите пример GetCampaigns.
Сначала перейдите в каталог google-ads-examples:
cd google-ads-examples
В этом примере требуется параметр --customerId, значением которого является идентификатор клиента вашего аккаунта Google Рекламы без дефисов (-).
Чтобы запустить с помощью 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"
Вы также можете использовать задачу listExamples в Gradle, чтобы получить список всех примеров, примеров в подкаталоге или примеров, в описании которых есть определенный поисковый запрос:
# 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'