Google Ads API-Clientbibliothek für Java

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, darunter die einfachere Verwaltung von Anmeldedaten und die Erstellung von Google Ads API-Dienstclients.

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 Datei pom.xml oder build.gradle, um die Versionen der Abhängigkeiten 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>48.0.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

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, die Sie durch alle wichtigen Schritte führt, einschließlich der Einrichtung Ihrer Google Ads-Konten.

Grundlegende Nutzung

Im Leitfaden zur grundlegenden Nutzung erfahren Sie wie Sie ein Projekt einrichten, Dienstclients instanziieren und Codebeispiele ausführen mit der Java-Clientbibliothek.

Authentifizierung und Autorisierung

Die Java-Clientbibliothek unterstützt mehrere Ansätze für die Authentifizierung und Autorisierung, 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 programmatische Konfiguration) sowie Logging-Funktionen zum Verfolgen von API Anfragen und ‑Antworten.

Dienstprogramme

Die Java-Clientbibliothek enthält Dienstprogrammklassen, um die API-Nutzung zu verbessern. Weitere Informationen finden Sie in den folgenden Leitfäden:

Anwendung optimieren

Im Leitfaden zur erweiterten Nutzung finden Sie Empfehlungen zur Optimierung der Time-outs, Wiederholungseinstellungen, Startlatenz und Abhängigkeitsverwaltung Ihrer Anwendung.