Die grundlegende Verwendung der Java-Clientbibliothek sieht so aus:
Neues Maven- oder Gradle-Projekt erstellen
Erstellen Sie ein neues Maven- oder Gradle-Projekt in der IDE Ihrer Wahl. Die Artefakte werden im Maven Central Repositoryveröffentlicht.
Verwenden Sie die Materialliste (Bill of Materials, BOM) der Google Ads API, um Abhängigkeitsversionen zu verwalten.
Wenn Sie die vorgefertigten Codebeispiele im
google-ads-examples Modul ausführen möchten, klonen Sie das google-ads-java
Repository von GitHub oder erstellen Sie es aus der Quelle. Wenn Sie es aus der Quelle erstellen, müssen Sie die Annotationsverarbeitung in Ihrer IDE aktivieren.
API-Zugriff konfigurieren
Um eine Verbindung zur Google Ads API herzustellen, müssen Sie Authentifizierungs- und Autorisierungsanmeldedaten angeben. Weitere Informationen zu den erforderlichen Anmeldedaten und zur Konfiguration der Clientbibliothek finden Sie im Leitfaden zur Authentifizierung und Autorisierung.
Ersten Aufruf ausführen
Nachdem Sie Ihre Anmeldedaten konfiguriert haben, können Sie Ihren ersten API-Aufruf ausführen.
Führen Sie das Beispiel
GetCampaigns aus, um Ihre Anmeldedaten zu validieren und Ihren ersten Aufruf mit dem geklonten
google-ads-java Repository auszuführen.
Wechseln Sie zuerst zum Verzeichnis google-ads-examples:
cd google-ads-examples
Für dieses Beispiel ist ein --customerId Parameter erforderlich, dessen Wert Ihre
Google Ads-Kundennummer ohne Bindestriche (-) ist.
So führen Sie das Beispiel mit Gradle aus:
./gradlew -q runExample \
--example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
So führen Sie das Beispiel mit Maven aus:
mvn exec:java \
-Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
-Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"
Weitere Beispiele ansehen
Das Beispielpaket in google-ads-examples
enthält mehrere nützliche Beispiele. Für die meisten Beispiele sind Parameter erforderlich. Sie können die Parameter entweder als Argumente übergeben (empfohlen) oder die Platzhalterwerte INSERT_..._HERE im Quellcode bearbeiten. Wenn Sie eine Nutzungsanweisung für ein Beispiel sehen möchten, übergeben Sie --help als einziges Argument.
Mit Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --help"
Sie können auch die Aufgabe listExamples in Gradle verwenden, um alle Beispiele, Beispiele in einem Unterverzeichnis oder Beispiele aufzulisten, in deren Beschreibung ein Suchbegriff enthalten ist:
# 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'