Основное использование клиентской библиотеки 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"
Изучите другие примеры
Пакет примеров в google-ads-examples содержит несколько полезных примеров. Для большинства примеров требуются параметры. Вы можете передать параметры как аргументы (рекомендуется) или изменить значения INSERT_XXXXX_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'