Einführung der google-ads-bom in die Google Ads API-Clientbibliothek für Java

Donnerstag, 18. September 2025

Wir freuen uns, die Veröffentlichung von google-ads-bom für die Google Ads API-Clientbibliothek für Java bekannt geben zu können. Diese Funktion ist jetzt mit Version 40.0.0 der google-ads-Clientbibliothek verfügbar. Diese neue Stückliste (Bill of Materials, BOM) soll die Verwaltung von Abhängigkeiten erheblich vereinfachen und die Stabilität Ihrer Google Ads API-Integrationen verbessern.

Was ist eine BOM?

Eine BOM ist ein Tool für die Build-Zeit, das ein zentrales, verbindliches „Regelwerk“ für die Verwaltung von Abhängigkeitsversionen bereitstellt. Wenn Sie unsere Stückliste importieren, wird in Ihrem Projekt genau die Gruppe kompatibler Abhängigkeitsversionen verwendet, mit denen der Google Ads-Client erstellt und getestet wurde. So lassen sich Abhängigkeitskonflikte mit Bibliotheken wie Guava und GAX, die auch von vielen anderen Frameworks verwendet werden, erheblich vermeiden.

google-ads-bom in den Code einbinden

Wenn Sie die Vorteile der google-ads-bom nutzen möchten, importieren Sie sie in den Abschnitt <dependencyManagement> Ihrer Build-Datei (z.B. pom.xml für Maven oder build.gradle für Gradle). Sie sollten dann die Versionsangabe aus der google-ads-Abhängigkeit im Abschnitt <dependencies> weglassen.

So binden Sie die BOM in Ihr Maven-Projekt ein:

<!-- Import the Bill of Materials (BOM) -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.google.api-ads</groupId>
            <artifactId>google-ads-bom</artifactId>
            <version>40.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<!-- Add the google-ads dependency without a version -->
<dependencies>
    <dependency>
        <groupId>com.google.api-ads</groupId>
        <artifactId>google-ads</artifactId>
    </dependency>
</dependencies>

So binden Sie die BOM in Ihr Gradle-Projekt ein:

// Import the Bill of Materials (BOM).
implementation platform('com.google.api-ads:google-ads-bom:40.0.0')

// Add the google-ads dependency, without a version. The version is managed by the BOM.
implementation 'com.google.api-ads:google-ads'

Abhängigkeiten deklarieren, die von der google-ads-bom abgedeckt werden

Die BOM verwaltet automatisch die Versionen für mehrere gängige Bibliotheken wie Guava, Protobuf, GAX und gRPC, um sie kompatibel zu machen. Um potenzielle Abhängigkeitskonflikte zu vermeiden, sollten Sie beim Deklarieren dieser Abhängigkeiten keine Version angeben. Wenn Sie beispielsweise Guava verwenden, deklarieren Sie es ohne Version:

In Maven:

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
</dependency>

Oder in Gradle:

implementation 'com.google.guava:guava' // NO VERSION SPECIFIED.

Mit dem Gradle-Task listAllDependencyConstraints können Sie eine Liste der eingeschränkten Abhängigkeiten abrufen, die über die BOM ohne deklarierte Version importiert werden können.

Weitere Informationen zu diesem neuen google-ads-bom-Angebot und zur Konfiguration Ihres Java-Clients finden Sie in unserem Startleitfaden.

 – Sarah Pollack, Google Ads API-Team

Labels: google-ads-api