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 Repository veröffentlicht.
Verwenden Sie die Google Ads API-Materialliste (Bill of Materials, BOM), um Abhängigkeitsversionen zu verwalten.
Wenn Sie die im google-ads-examples-Modul enthaltenen vordefinierten Codebeispiele ausführen möchten, klonen Sie das google-ads-java-Repository von GitHub oder erstellen Sie es aus der Quelle. Wenn Sie aus der Quelle erstellen, müssen Sie die Annotationsverarbeitung in Ihrer IDE aktivieren.
API-Zugriff konfigurieren
Wenn Sie eine Verbindung zur Google Ads API herstellen möchten, müssen Sie Anmeldedaten für die Authentifizierung und Autorisierung angeben. Weitere Informationen zu den erforderlichen Anmeldedaten und zur Konfiguration der Clientbibliothek finden Sie im Leitfaden zur Authentifizierung und Autorisierung.
Ersten Anruf starten
Nachdem Sie Ihre Anmeldedaten konfiguriert haben, können Sie Ihren ersten API-Aufruf ausführen.
Führen Sie das GetCampaigns-Beispiel aus, um Ihre Anmeldedaten zu validieren und den 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 die Kundennummer Ihres Google Ads-Kontos ohne Bindestriche (-) ist.
So führen Sie die Pipeline mit Gradle aus:
./gradlew -q runExample \
--example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
So führen Sie die Anwendung 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 Paket examples 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, deren Beschreibung einen Suchbegriff enthält:
# 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'