Java 用 Google Ads API クライアント ライブラリに google-ads-bom を導入

2025 年 9 月 18 日（木曜日）

このたび、Java 用 Google Ads API クライアント ライブラリの google-ads-bom がリリースされました。google-ads クライアント ライブラリの v40.0.0 でご利用いただけます。この新しい部品構成表（BOM）は、依存関係の管理を大幅に簡素化し、Google Ads API 統合の安定性を高めるように設計されています。

BOM とは

BOM は、依存関係のバージョンを管理するための一元化された信頼できる「ルールブック」を提供するビルド時ツールです。BOM をインポートすると、Google 広告クライアントのビルドとテストに使用された互換性のある依存関係バージョンがプロジェクトで使用されるようになります。これにより、Guava や GAX などのライブラリとの依存関係の競合を回避できます。これらのライブラリは、他の多くのフレームワークでも使用されています。

google-ads-bom をコードに組み込む方法

google-ads-bom のメリットを活用するには、ビルドファイルの <dependencyManagement> セクション（Maven の場合は pom.xml、Gradle の場合は build.gradle など）にインポートします。その場合、<dependencies> セクションの google-ads 依存関係からバージョン指定を省略する必要があります。

Maven プロジェクトに BOM を含める方法:

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

Gradle プロジェクトに BOM を含める方法:

// 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 の対象となる依存関係を宣言する

BOM は、Guava、Protobuf、GAX、gRPC などの一般的なライブラリのバージョンを自動的に管理して、互換性を確保します。依存関係の競合を回避するため、これらの依存関係を宣言するときにバージョンを指定しないでください。たとえば、Guava を使用している場合は、バージョンを指定せずに宣言します。

Maven の場合:

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

または、Gradle の場合: 

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

バージョンを宣言せずに BOM を使用してインポートできる制約付き依存関係のリストを取得するには、listAllDependencyConstraints Gradle タスクを使用します。

この新しい google-ads-bom サービスと Java クライアントの構成方法について詳しくは、スタートガイドをご覧ください。

 - Sarah Pollack、Google Ads API チーム

ラベル: google-ads-api