Présentation de google-ads-bom pour la bibliothèque cliente de l'API Google Ads pour Java

Jeudi 18 septembre 2025

Nous sommes ravis d'annoncer la sortie de la google-ads-bom pour la bibliothèque cliente de l'API Google Ads pour Java, désormais disponible avec la version 40.0.0 de la bibliothèque cliente google-ads. Cette nouvelle nomenclature (BOM) est conçue pour simplifier considérablement la gestion de vos dépendances et améliorer la stabilité de vos intégrations de l'API Google Ads.

Qu'est-ce qu'une nomenclature ?

Une nomenclature est un outil de compilation qui fournit un "ensemble de règles" centralisé et faisant autorité pour gérer les versions des dépendances. En important notre BOM, vous vous assurez que votre projet utilise l'ensemble exact de versions de dépendances compatibles avec lesquelles le client Google Ads a été créé et testé. Cela permet d'éviter les conflits de dépendances avec des bibliothèques telles que Guava et GAX, qui sont également utilisées par de nombreux autres frameworks.

Intégrer google-ads-bom à votre code

Pour profiter des avantages de google-ads-bom, importez-le dans la section <dependencyManagement> de votre fichier de compilation (par exemple, pom.xml pour Maven ou build.gradle pour Gradle). Vous devez ensuite omettre la spécification de version de la dépendance google-ads dans la section <dependencies>.

Pour inclure la nomenclature dans votre projet Maven : 

<!-- 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>

Pour inclure la nomenclature dans votre projet Gradle : 

// 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'

Déclarer les dépendances couvertes par google-ads-bom

La nomenclature gère automatiquement les versions de plusieurs bibliothèques courantes, telles que Guava, Protobuf, GAX et gRPC, pour les rendre compatibles. Pour éviter d'éventuels conflits de dépendances, vous ne devez pas spécifier de version lorsque vous déclarez ces dépendances. Par exemple, si vous utilisez Guava, vous le déclarerez sans version :

Dans Maven : 

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

Ou dans Gradle : 

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

Pour récupérer la liste des dépendances limitées qui peuvent être importées à l'aide de la nomenclature sans version déclarée, utilisez la tâche Gradle listAllDependencyConstraints.

Pour en savoir plus sur cette nouvelle offre google-ads-bom et sur la configuration de votre client Java, consultez notre guide de démarrage.

 - Sarah Pollack, équipe API Google Ads

Libellés : google-ads-api