Memperkenalkan google-ads-bom ke library klien Google Ads API untuk Java

Kamis, 18 September 2025

Dengan senang hati kami mengumumkan rilis google-ads-bom untuk library klien Google Ads API untuk Java, yang kini tersedia dengan library klien google-ads v40.0.0. Bill of Materials (BOM) baru ini dirancang untuk menyederhanakan pengelolaan dependensi Anda secara signifikan dan meningkatkan stabilitas integrasi Google Ads API Anda.

Apa yang dimaksud dengan BOM?

BOM adalah alat waktu build yang menyediakan "buku aturan" terpusat dan otoritatif untuk mengelola versi dependensi. Dengan mengimpor BOM kami, Anda memastikan project Anda menggunakan kumpulan versi dependensi kompatibel yang tepat yang digunakan untuk mem-build dan menguji klien Google Ads. Hal ini sangat membantu menghindari konflik dependensi dengan library seperti Guava dan GAX, yang juga digunakan oleh banyak framework lain.

Cara menggabungkan google-ads-bom ke dalam kode Anda

Untuk memanfaatkan manfaat google-ads-bom, impor ke bagian <dependencyManagement> file build Anda (misalnya, pom.xml untuk Maven atau build.gradle untuk Gradle). Kemudian, Anda harus menghilangkan spesifikasi versi dari dependensi google-ads di bagian <dependencies>.

Cara menyertakan BOM dalam project Maven Anda:

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

Cara menyertakan BOM dalam project Gradle Anda:

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

Mendeklarasikan dependensi yang tercakup dalam google-ads-bom

BOM otomatis mengelola versi untuk beberapa library umum–seperti Guava, Protobuf, GAX, dan gRPC–agar kompatibel. Untuk menghindari potensi konflik dependensi, Anda tidak boleh menentukan versi saat mendeklarasikan dependensi ini. Misalnya, jika menggunakan Guava, Anda akan mendeklarasikannya tanpa versi:

Di Maven:

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

Atau di Gradle:

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

Untuk mengambil daftar dependensi terbatas yang dapat diimpor menggunakan BOM tanpa versi yang dideklarasikan, gunakan tugas gradle listAllDependencyConstraints.

Untuk mempelajari lebih lanjut penawaran google-ads-bom baru ini dan cara mengonfigurasi klien Java, lihat panduan memulai kami.

 - Sarah Pollack, Tim Google Ads API

Label: google-ads-api