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. Nasze artefakty są publikowane w centralnym repozytorium Maven.
Do zarządzania wersjami zależności zalecamy używanie zestawienia materiałów (BOM) interfejsu Google Ads API.
Możesz też utworzyć go na podstawie źródła. Na potrzeby tego przewodnika zakładamy, że masz już skonfigurowany projekt z wymaganymi zależnościami.
Jeśli tworzysz projekt na podstawie kodu źródłowego, upewnij się, że w IDE masz włączone 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 logowania i konfigurowaniu biblioteki klienta znajdziesz w przewodniku Uwierzytelnianie i autoryzacja.
Wykonaj pierwsze połączenie
Po skonfigurowaniu danych logowania możesz wykonać pierwsze wywołanie interfejsu API.
Aby zweryfikować dane logowania i wykonać pierwsze wywołanie, uruchomimy 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 myślników.
Aby uruchomić za pomocą Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Zobacz inne przykłady
Pakiet examples w google-ads-examples zawiera kilka przydatnych przykładów. Większość przykładów wymaga parametrów. Parametry możesz przekazywać jako argumenty (zalecane) lub edytować wartości INSERT_XXXXX_HERE w kodzie źródłowym. Aby wyświetlić instrukcję użycia
na przykładzie, przekaż --help jako jedyny argument.
W przypadku 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, w których opis zawiera wyszukiwane słowo.
# 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'