Основной принцип использования клиентской библиотеки Java выглядит следующим образом:
Создайте новый проект Maven или Gradle.
Создайте новый проект Maven или Gradle в выбранной вами IDE. Наши артефакты публикуются в центральном репозитории Maven .
Мы рекомендуем использовать спецификацию компонентов (BOM) API Google Ads для управления версиями зависимостей.
Вы также можете выполнить сборку из исходного кода . В целях данного руководства предполагается, что у вас уже настроен проект с необходимыми зависимостями.
Если вы собираете проект из исходного кода, убедитесь, что в вашей IDE включена обработка аннотаций.
Настройка доступа к API
Для подключения к API Google Ads необходимо предоставить учетные данные для аутентификации и авторизации. Подробную информацию о необходимых учетных данных и настройке клиентской библиотеки см. в руководстве по аутентификации и авторизации .
Сделайте свой первый звонок
После настройки учетных данных вы готовы совершить свой первый вызов API.
Для проверки ваших учетных данных и выполнения первого звонка мы запустим пример GetCampaigns .
Для начала перейдите в каталог google-ads-examples .
cd google-ads-examples
В этом примере требуется параметр --customerId , значением которого является идентификатор клиента вашего аккаунта Google Ads без дефисов.
Для запуска с помощью Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Изучите другие примеры.
Пакет examples в google-ads-examples содержит несколько полезных примеров. Большинство примеров требуют параметров. Вы можете либо передать параметры в качестве аргументов (рекомендуется), либо отредактировать значения INSERT_XXXXX_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'