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 Ads 客户端构建和测试时完全相同的兼容依赖项版本集。这有助于避免与 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