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. Unsere Artefakte werden im zentralen Maven-Repository veröffentlicht.
Wir empfehlen, die Google Ads API-Stückliste (Bill of Materials, BOM) zur Verwaltung von Abhängigkeitsversionen zu verwenden.
Sie können auch aus der Quelle 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
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.
Um Ihre Anmeldedaten zu bestätigen und Ihren ersten Aufruf zu starten, führen wir das GetCampaigns-Beispiel aus.
Wechseln Sie zuerst in das 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"
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_XXXXX_HERE-Werte 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"
Mit dem Task listExamples in Gradle können Sie auch alle Beispiele, Beispiele in einem Unterverzeichnis oder Beispiele auflisten, in denen die 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'