Добавление google-ads-bom в клиентскую библиотеку Google Ads API для Java

Четверг, 18 сентября 2025 г.

Мы рады сообщить о выпуске google-ads-bom для API-клиента Google Ads API для Java, которая теперь доступна в версии 40.0.0 клиентской библиотеки google-ads. Новая спецификация материалов (BOM) значительно упрощает управление зависимостями и повышает стабильность интеграции с Google Ads API.

Что такое спецификация?

BOM – это инструмент времени сборки, который предоставляет централизованный авторитетный "свод правил" для управления версиями зависимостей. Импортируя наш BOM, вы гарантируете, что в вашем проекте используется именно тот набор совместимых версий зависимостей, на основе которого был создан и протестирован клиент Google Рекламы. Это помогает избежать конфликтов зависимостей с библиотеками, такими как Guava и GAX, которые также используются многими другими фреймворками.

Как добавить google-ads-bom в код

Чтобы воспользоваться преимуществами google-ads-bom, импортируйте его в раздел <dependencyManagement> файла сборки (например, pom.xml для Maven или build.gradle для Gradle). Затем удалите спецификацию версии из зависимости google-ads в разделе <dependencies>.

Как включить BOM в проект 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>

Чтобы включить BOM в проект 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'

Объявление зависимостей, охватываемых 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 без объявленной версии, используйте задачу gradle listAllDependencyConstraints.

Чтобы узнать больше о новом предложении google-ads-bom и о том, как настроить клиент Java, ознакомьтесь с нашим руководством по началу работы.

 - Сара Поллак, команда Google Ads API

Ярлыки: google-ads-api