Java için Google Ads API istemci kitaplığına google-ads-bom'un eklenmesi

18 Eylül 2025, Perşembe

Java için Google Ads API istemci kitaplığı'na yönelik google-ads-bom'ın kullanıma sunulduğunu duyurmaktan heyecan duyuyoruz. Bu özellik, google-ads istemci kitaplığının 40.0.0 sürümünde kullanılabilir. Bu yeni Malzeme Listesi (BOM), bağımlılık yönetiminizi önemli ölçüde basitleştirmek ve Google Ads API entegrasyonlarınızın kararlılığını artırmak için tasarlanmıştır.

BOM nedir?

BOM, bağımlılık sürümlerini yönetmek için merkezi ve yetkili bir "kural kitabı" sağlayan bir derleme zamanı aracıdır. BOM'umuzu içe aktararak projenizin, Google Ads istemcisinin oluşturulduğu ve test edildiği uyumlu bağımlılık sürümlerini kullandığından emin olursunuz. Bu, diğer birçok çerçeve tarafından da kullanılan Guava ve GAX gibi kitaplıklarla bağımlılık çakışmalarını önlemeye önemli ölçüde yardımcı olur.

google-ads-bom öğesini kodunuza ekleme

google-ads-bom avantajlarından yararlanmak için bunu derleme dosyanızın <dependencyManagement> bölümüne aktarın (ör. Maven için pom.xml veya Gradle için build.gradle). Ardından, <dependencies> bölümündeki google-ads bağımlılığından sürüm spesifikasyonunu çıkarmanız gerekir.

BOM'u Maven projenize ekleme:

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

BOM'u Gradle projenize ekleme:

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

google-ads-bom tarafından kapsanan bağımlılıkları bildirme

BOM, Guava, Protobuf, GAX ve gRPC gibi yaygın olarak kullanılan çeşitli kitaplıkların sürümlerini otomatik olarak yöneterek uyumlu hale getirir. Olası bağımlılık çakışmalarını önlemek için bu bağımlılıkları bildirirken bir sürüm belirtmemeniz gerekir. Örneğin, Guava kullanıyorsanız sürüm belirtmeden tanımlarsınız:

Maven'da:

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

Gradle'da:

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

BOM kullanılarak içe aktarılabilen ve sürümü belirtilmemiş kısıtlanmış bağımlılıkların listesini almak için listAllDependencyConstraints Gradle görevini kullanın.

Bu yeni google-ads-bom teklifi ve Java istemcinizi nasıl yapılandıracağınız hakkında daha fazla bilgi edinmek için başlangıç kılavuzumuzu inceleyin.

 - Sarah Pollack, Google Ads API Ekibi

Etiketler: google-ads-api