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 eine 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 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>48.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

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 Ansätze zur Authentifizierung und Autorisierung, darunter OAuth 2.0-Desktop- und Webanwendungsabläufe, 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) und Logging-Funktionen zum Verfolgen von API-Anfragen und -Antworten.

Dienstprogramme

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

Anwendung optimieren

Im Leitfaden für die erweiterte Nutzung finden Sie Empfehlungen zur Feinabstimmung der Zeitlimits, Wiederholungseinstellungen, Startlatenz und Abhängigkeitsverwaltung Ihrer Anwendung.