Podstawowe użycie biblioteki klienta Java wygląda tak:
Tworzenie nowego projektu Maven lub Gradle
Utwórz nowy projekt Maven lub Gradle w wybranym środowisku IDE. Artefakty są publikowane w Centralnym repozytorium Maven.
Do zarządzania wersjami zależności używaj pliku BOM interfejsu Google Ads API.
Jeśli chcesz uruchomić gotowe przykłady kodu zawarte w module google-ads-examples, sklonuj repozytorium google-ads-java z GitHuba lub utwórz je ze źródła. Jeśli kompilujesz ze źródła, upewnij się, że w środowisku IDE włączone jest przetwarzanie adnotacji.
Konfigurowanie dostępu do interfejsu API
Aby połączyć się z interfejsem Google Ads API, musisz podać dane uwierzytelniające i autoryzacyjne. Szczegółowe informacje o wymaganych danych uwierzytelniających i konfigurowaniu biblioteki klienta znajdziesz w przewodniku po uwierzytelnianiu i autoryzacji.
Nawiązywanie pierwszego połączenia
Po skonfigurowaniu danych logowania możesz wykonać pierwsze wywołanie interfejsu API.
Aby zweryfikować dane logowania i wykonać pierwsze wywołanie za pomocą sklonowanego repozytorium google-ads-java, uruchom przykład GetCampaigns.
Najpierw przejdź do katalogu google-ads-examples:
cd google-ads-examples
Ten przykład wymaga parametru --customerId, którego wartością jest identyfikator klienta konta Google Ads bez łączników (-).
Aby uruchomić za pomocą Gradle:
./gradlew -q runExample \
--example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Aby uruchomić za pomocą Maven:
mvn exec:java \
-Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
-Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"
Inne przykłady
Pakiet examples w google-ads-examples zawiera kilka przydatnych przykładów. Większość przykładów wymaga parametrów. Możesz przekazać parametry jako argumenty (zalecane) lub edytować wartości zmiennych INSERT_..._HERE w kodzie źródłowym. Aby zobaczyć przykładowe instrukcje użycia, podaj --help jako jedyny argument.
W Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --help"
Możesz też użyć zadania listExamples w Gradle, aby wyświetlić listę wszystkich przykładów, przykładów w podkatalogu lub przykładów, których opis zawiera wyszukiwane hasło:
# 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'