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 클라이언트를 구성하는 방법에 대해 자세히 알아보려면 시작 가이드를 확인하세요.

 - 사라 폴락, Google Ads API팀

라벨: google-ads-api