Die Clientbibliothek für Java wird auf GitHub gehostet und über Maven Central verteilt. Sie bietet mehrere Funktionen, die Ihnen die Verwendung der API erleichtern, z. B. die einfache Verwaltung von Anmeldedaten und die Erstellung von Google Ads API-Serviceclients.
Für die Bibliothek ist Java 8 oder höher erforderlich.
Installation
Verwenden Sie die Google Ads API-Materialliste (Bill of Materials, BOM) in Ihrer pom.xml- oder build.gradle-Datei, um Abhängigkeitsversionen zu verwalten:
<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
versions of all google-ads libraries. -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads-bom</artifactId>
<version>46.1.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Add the google-ads dependency, without a version. The version is
managed by the BOM. -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
</dependency>
Sie können die Bibliothek auch aus der Quelle erstellen.
Der erste API-Aufruf
Videobibliothek: Erste Schritte mit der Java-Clientbibliothek
Wenn Sie die Google Ads API verwenden möchten, müssen Sie mehrere Schritte ausführen, um Zugriff auf die API zu erhalten und Ihre Google Ads-Konten zu konfigurieren. Folgen Sie der Kurzanleitung, in der alle wichtigen Schritte beschrieben werden, einschließlich der Einrichtung Ihrer Google Ads-Konten.
Grundlegende Nutzung
Im Leitfaden zur grundlegenden Verwendung erfahren Sie, wie Sie ein Projekt einrichten, Dienstclients instanziieren und Codebeispiele mit der Java-Clientbibliothek ausführen.
Authentifizierung und Autorisierung
Die Java-Clientbibliothek unterstützt mehrere Authentifizierungs- und Autorisierungsansätze, darunter OAuth 2.0-Abläufe für Desktop- und Webanwendungen, Dienstkonten und Standardanmeldedaten für Anwendungen. Weitere Informationen finden Sie im Leitfaden zur Authentifizierung und Autorisierung.
Konfiguration und Logging
Die Java-Clientbibliothek unterstützt mehrere Konfigurationsoptionen (einschließlich ads.properties-Dateien, Umgebungsvariablen und programmatischer Konfiguration) sowie Protokollierungsfunktionen zum Nachverfolgen von API-Anfragen und ‑Antworten.
Dienstprogramme
Die Java-Clientbibliothek enthält Hilfsklassen, die die API-Nutzung vereinfachen. Weitere Informationen finden Sie in den folgenden Leitfäden:
- FieldMasks: Hilfsklassen zum Erstellen und Berechnen von Aktualisierungsfeldmasken.
- ResourceNames: Dienstprogramme zum Formatieren von Strings mit Ressourcennamen von Entitäten.
- Vorgänge mit langer Ausführungszeit: Hilfsprogramme zum Überwachen und Verwalten asynchroner API-Vorgänge.
Anwendung optimieren
Im Leitfaden zur erweiterten Verwendung finden Sie Empfehlungen zum Optimieren der Zeitüberschreitungen, Wiederholungseinstellungen, Startlatenz und Abhängigkeitsverwaltung Ihrer Anwendung.