Wprowadzenie google-ads-bom do biblioteki klienta interfejsu Google Ads API dla języka Java

Czwartek, 18 września 2025 r.

Z przyjemnością informujemy o wydaniu wersji google-ads-bom biblioteki klienta interfejsu Google Ads API dla języka Java, która jest teraz dostępna w wersji 40.0.0 biblioteki klienta google-ads. To nowe zestawienie komponentów (BOM) ma na celu znaczne uproszczenie zarządzania zależnościami i zwiększenie stabilności integracji z interfejsem Google Ads API.

Co to jest BOM?

BOM to narzędzie do kompilacji, które zapewnia scentralizowany, autorytatywny „zbiór reguł” do zarządzania wersjami zależności. Importując nasz zestaw BOM, masz pewność, że Twój projekt używa dokładnie tego zestawu zgodnych wersji zależności, na podstawie którego utworzono i przetestowano klienta Google Ads. Pomaga to znacznie uniknąć konfliktów zależności z bibliotekami takimi jak Guava i GAX, które są również używane przez wiele innych platform.

Jak umieścić google-ads-bom w kodzie

Aby korzystać z zalet google-ads-bom, zaimportuj go do sekcji <dependencyManagement> pliku kompilacji (np. pom.xml w przypadku Maven lub build.gradle w przypadku Gradle). Następnie należy pominąć specyfikację wersji z zależności google-ads w sekcji <dependencies>.

Aby uwzględnić BOM w projekcie 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>

Aby uwzględnić BOM w projekcie 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'

Deklarowanie zależności objętych przez google-ads-bom

BOM automatycznie zarządza wersjami kilku popularnych bibliotek, takich jak Guava, Protobuf, GAX i gRPC, aby zapewnić ich zgodność. Aby uniknąć potencjalnych konfliktów zależności, nie podawaj wersji podczas deklarowania tych zależności. Jeśli na przykład używasz Guava, zadeklarujesz ją bez wersji:

W Maven:

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

lub w Gradle:

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

Aby pobrać listę ograniczonych zależności, które można zaimportować za pomocą BOM bez zadeklarowanej wersji, użyj zadania gradle listAllDependencyConstraints.

Więcej informacji o nowej ofercie google-ads-bom i konfigurowaniu klienta Java znajdziesz w przewodniku dla początkujących.

 – Sarah Pollack, zespół ds. interfejsu Google Ads API

Etykiety: google-ads-api