Podstawowe użycie biblioteki klienta Java wygląda tak:
Tworzenie nowego projektu Maven lub Gradle
Utwórz nowy projekt Maven lub Gradle w wybranym IDE. Nasze artefakty są publikowane w centralnym repozytorium Maven.
Do zarządzania wersjami zależności zalecamy używanie listy materiałów interfejsu Google Ads API (BOM).
Możesz też utworzyć projekt ze źródeł. Na potrzeby tego przewodnika zakładamy, że masz skonfigurowany projekt z wymaganymi zależnościami.
Jeśli tworzysz projekt ze źródeł, włącz przetwarzanie adnotacji w IDE.
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 sposobie konfigurowania biblioteki klienta znajdziesz w przewodniku Uwierzytelnianie i autoryzacja.
Pierwsze wywołanie
Po skonfigurowaniu danych uwierzytelniających możesz wykonać pierwsze wywołanie interfejsu API.
Aby zweryfikować dane uwierzytelniające i wykonać pierwsze wywołanie, uruchomimy przykład GetCampaigns.
Najpierw otwórz katalog google-ads-examples.
cd google-ads-examples
Ten przykład wymaga parametru --customerId, którego wartością jest identyfikator klienta konta Google Ads bez kresek.
Aby uruchomić przykład w Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Poznawanie innych przykładów
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 przykładu, przekaż --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'