Thứ Năm, ngày 18 tháng 9 năm 2025
Chúng tôi rất vui mừng được thông báo về việc phát hành google-ads-bom cho thư viện ứng dụng Google Ads API cho Java, hiện đã có trong phiên bản 40.0.0 của thư viện ứng dụng google-ads. BOM mới này được thiết kế để đơn giản hoá đáng kể việc quản lý phần phụ thuộc và tăng cường độ ổn định của các chế độ tích hợp Google Ads API.
BOM là gì?
BOM là một công cụ thời gian xây dựng, cung cấp một "bộ quy tắc" tập trung và có thẩm quyền để quản lý các phiên bản phần phụ thuộc. Bằng cách nhập BOM, bạn đảm bảo dự án của mình sử dụng đúng tập hợp các phiên bản phần phụ thuộc tương thích mà ứng dụng Google Ads được xây dựng và thử nghiệm. Điều này giúp tránh đáng kể xung đột phần phụ thuộc với các thư viện như Guava và GAX, vốn cũng được nhiều khung khác sử dụng.
Cách kết hợp google-ads-bom vào mã của bạn
Để tận dụng lợi ích của google-ads-bom, hãy nhập tệp này vào phần <dependencyManagement> của tệp bản dựng (ví dụ: pom.xml cho Maven hoặc build.gradle cho Gradle). Sau đó, bạn nên bỏ qua thông số phiên bản khỏi phần phụ thuộc google-ads trong phần <dependencies>.
Cách thêm BOM vào dự án 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>
Cách đưa BOM vào dự án 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'
Khai báo các phần phụ thuộc thuộc phạm vi của google-ads-bom
BOM tự động quản lý các phiên bản cho một số thư viện phổ biến (chẳng hạn như Guava, Protobuf, GAX và gRPC) để đảm bảo khả năng tương thích. Để tránh xung đột phần phụ thuộc có thể xảy ra, bạn không nên chỉ định phiên bản khi khai báo các phần phụ thuộc này. Ví dụ: nếu đang sử dụng Guava, bạn sẽ khai báo mà không cần phiên bản:
Trong Maven:
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
</dependency>Hoặc trong Gradle:
implementation 'com.google.guava:guava' // NO VERSION SPECIFIED.
Để truy xuất danh sách các phần phụ thuộc bị ràng buộc có thể nhập bằng BOM mà không có phiên bản được khai báo, hãy sử dụng tác vụ gradle listAllDependencyConstraints.
Để tìm hiểu thêm về dịch vụ google-ads-bom mới này và cách định cấu hình ứng dụng Java, hãy xem hướng dẫn bắt đầu sử dụng của chúng tôi.
Nhãn: google-ads-api