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 vorgefertigten Codebeispiele aus dem 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 aus dem Quellcode 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 Authentifizierungs- und Autorisierungsanmeldedaten 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.
Um Ihre Anmeldedaten zu validieren und Ihren ersten Aufruf mit dem geklonten google-ads-java-Repository auszuführen, führen Sie das GetCampaigns-Beispiel aus.
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 den Test mit Gradle aus:
./gradlew -q runExample \
--example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
So führen Sie die App 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 INSERT_..._HERE-Platzhalterwerte 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 den Task 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'