Introduzione di google-ads-bom alla libreria client dell'API Google Ads per Java

Giovedì 18 settembre 2025

Siamo felici di annunciare il rilascio di google-ads-bom per la libreria client dell'API Google Ads per Java, ora disponibile con la versione 40.0.0 della libreria client google-ads. Questa nuova distinta base (BOM) è progettata per semplificare notevolmente la gestione delle dipendenze e migliorare la stabilità delle integrazioni dell'API Google Ads.

Che cos'è una distinta base?

Una BOM è uno strumento di build-time che fornisce un "regolamento" centralizzato e autorevole per la gestione delle versioni delle dipendenze. Importando la nostra distinta base, ti assicuri che il tuo progetto utilizzi l'insieme esatto di versioni delle dipendenze compatibili con cui è stato creato e testato il client Google Ads. In questo modo, è molto più facile evitare conflitti di dipendenza con librerie come Guava e GAX, utilizzate anche da molti altri framework.

Come incorporare google-ads-bom nel codice

Per sfruttare i vantaggi del google-ads-bom, importalo nella sezione <dependencyManagement> del file di build (ad es. pom.xml per Maven o build.gradle per Gradle). Dovresti quindi omettere la specifica della versione dalla dipendenza google-ads nella sezione <dependencies>.

Come includere la BOM nel tuo progetto 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>

Come includere la BOM nel progetto 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'

Dichiarazione delle dipendenze coperte da google-ads-bom

La distinta base gestisce automaticamente le versioni di diverse librerie comuni, come Guava, Protobuf, GAX e gRPC, per renderle compatibili. Per evitare potenziali conflitti di dipendenze, non devi specificare una versione quando dichiari queste dipendenze. Ad esempio, se utilizzi Guava, lo dichiari senza una versione:

In Maven: 

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

In alternativa, in Gradle: 

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

Per recuperare un elenco di dipendenze vincolate che possono essere importate utilizzando la BOM senza una versione dichiarata, utilizza l'attività gradle listAllDependencyConstraints.

Per scoprire di più su questa nuova offerta google-ads-bom e su come configurare il tuo client Java, consulta la nostra guida introduttiva.

 - Sarah Pollack, team API Google Ads

Labels: google-ads-api