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. Artefakty są publikowane w centralnym repozytorium Maven.
Do zarządzania wersjami zależności używaj listy materiałów (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 skompiluj je ze źródeł. Jeśli kompilujesz ze źródeł, włącz w IDE 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 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 za pomocą sklonowanego
google-ads-java repozytorium, uruchom
GetCampaigns przykład.
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"
Sprawdzanie innych przykładów
Pakiet przykładów 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 zmiennych zastępczych INSERT_..._HERE w kodzie źródłowym. Aby wyświetlić instrukcję użycia przykładu, przekaż --help jako jedyny argument.
Za pomocą 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 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'