Die grundlegende Verwendung der Java-Clientbibliothek sieht so aus:
Neues Maven- oder Gradle-Projekt erstellen
Erstellen Sie in der IDE Ihrer Wahl ein neues Maven- oder Gradle-Projekt. Unsere Artefakte werden im zentralen Maven Repository veröffentlicht.
Wir empfehlen, die Materialliste (Bill of Materials, BOM) der Google Ads API zu verwenden, um Abhängigkeitsversionen zu verwalten.
Sie können auch aus dem Quellcode erstellen. Für diese Anleitung wird davon ausgegangen, dass Sie ein Projekt mit den erforderlichen Abhängigkeiten eingerichtet haben.
Wenn Sie aus dem Quellcode 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 zum Konfigurieren der Clientbibliothek finden Sie in der Anleitung zur Authentifizierung und Autorisierung .
Ersten Aufruf ausführen
Nachdem Sie Ihre Anmeldedaten konfiguriert haben, können Sie Ihren ersten API-Aufruf ausführen.
Um Ihre Anmeldedaten zu bestätigen und Ihren ersten Aufruf auszuführen, führen wir das Beispiel GetCampaigns aus.
Rufen Sie zuerst das Verzeichnis google-ads-examples auf.
cd google-ads-examples
Für dieses Beispiel ist ein Parameter --customerId erforderlich, dessen Wert Ihre Google Ads-Kunden-ID ohne Bindestriche ist.
So führen Sie das Beispiel mit Gradle aus:
./gradlew -q runExample --example="basicoperations.GetCampaigns --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 Werte INSERT_XXXXX_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'