Presentamos google-ads-bom en la biblioteca cliente de la API de Google Ads para Java

Jueves, 18 de septiembre de 2025

Nos complace anunciar el lanzamiento de google-ads-bom para la biblioteca cliente de la API de Google Ads para Java, que ya está disponible con la versión 40.0.0 de la biblioteca cliente de google-ads. Esta nueva lista de materiales (BOM) está diseñada para simplificar significativamente la administración de dependencias y mejorar la estabilidad de tus integraciones de la API de Google Ads.

¿Qué es una BOM?

Una BoM es una herramienta de tiempo de compilación que proporciona un "libro de reglas" centralizado y autorizado para administrar las versiones de las dependencias. Si importas nuestra BOM, te aseguras de que tu proyecto use el conjunto exacto de versiones de dependencias compatibles con las que se compiló y probó el cliente de Google Ads. Esto ayuda de forma significativa a evitar conflictos de dependencia con bibliotecas como Guava y GAX, que también usan muchos otros frameworks.

Cómo incorporar el google-ads-bom en tu código

Para aprovechar los beneficios de la google-ads-bom, impórtala en la sección <dependencyManagement> de tu archivo de compilación (p.ej., pom.xml para Maven o build.gradle para Gradle). Luego, debes omitir la especificación de la versión de la dependencia google-ads en la sección <dependencies>.

Cómo incluir la BoM en tu proyecto de 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>

Cómo incluir la BoM en tu proyecto de 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'

Cómo declarar dependencias cubiertas por google-ads-bom

La BOM administra automáticamente las versiones de varias bibliotecas comunes, como Guava, Protobuf, GAX y gRPC, para que sean compatibles. Para evitar posibles conflictos de dependencias, no debes especificar una versión cuando declares estas dependencias. Por ejemplo, si usas Guava, la declararías sin una versión:

En Maven: 

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

O en Gradle: 

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

Para recuperar una lista de dependencias restringidas que se pueden importar con la BoM sin una versión declarada, usa la tarea de Gradle listAllDependencyConstraints.

Para obtener más información sobre esta nueva oferta de google-ads-bom y cómo configurar tu cliente de Java, consulta nuestra guía de introducción.

 - Sarah Pollack, equipo de la API de Google Ads

Etiquetas: google-ads-api