Introdução do google-ads-bom à biblioteca de cliente da API Google Ads para Java

Quinta-feira, 18 de setembro de 2025

Temos o prazer de anunciar o lançamento do google-ads-bom para a biblioteca de cliente da API Google Ads para Java, agora disponível com a versão 40.0.0 da biblioteca de cliente google-ads. Essa nova lista de materiais (BOM, na sigla em inglês) foi criada para simplificar significativamente o gerenciamento de dependências e melhorar a estabilidade das suas integrações com a API Google Ads.

O que é uma BOM?

Uma BoM é uma ferramenta de tempo de build que fornece um "livro de regras" centralizado e oficial para gerenciar versões de dependências. Ao importar nossa BOM, você garante que seu projeto use o conjunto exato de versões de dependência compatíveis com as quais o cliente do Google Ads foi criado e testado. Isso ajuda significativamente a evitar conflitos de dependência com bibliotecas como Guava e GAX, que também são usadas por muitos outros frameworks.

Como incorporar o google-ads-bom ao seu código

Para aproveitar os benefícios da google-ads-bom, importe-a para a seção <dependencyManagement> do seu arquivo de build (por exemplo, pom.xml para Maven ou build.gradle para Gradle). Em seguida, omita a especificação da versão da dependência google-ads na seção <dependencies>.

Como incluir a BOM no seu projeto do 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>

Como incluir a BOM no seu projeto do 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'

Como declarar dependências cobertas pelo google-ads-bom

A BOM gerencia automaticamente as versões de várias bibliotecas comuns, como Guava, Protobuf, GAX e gRPC, para torná-las compatíveis. Para evitar possíveis conflitos de dependência, não especifique uma versão ao declarar essas dependências. Por exemplo, se você estiver usando o Guava, declare-o sem uma versão:

No Maven: 

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

Ou no Gradle: 

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

Para recuperar uma lista de dependências restritas que podem ser importadas usando a BOM sem uma versão declarada, use a tarefa listAllDependencyConstraints do Gradle.

Para saber mais sobre essa nova oferta do google-ads-bom e como configurar seu cliente Java, confira nosso guia de iniciação.

 - Sarah Pollack, equipe da API Google Ads

Marcadores: google-ads-api