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.
Użyj zestawienia materiałów (BOM) interfejsu Google Ads API, aby zarządzać wersjami zależności.
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 tworzysz aplikację na podstawie kodu źródłowego, 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 logowania 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 repozytoriumgoogle-ads-java, uruchom GetCampaignsprzykł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"
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 zmiennych zastępczych INSERT_..._HERE w kodzie źródłowym. Aby wyświetlić instrukcję użycia, 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'