Thư viện ứng dụng cho Java được lưu trữ trên GitHub và phân phối thông qua Maven Central. Thư viện này cung cấp một số tính năng giúp bạn sử dụng API, bao gồm cả việc quản lý thông tin xác thực và tạo ứng dụng dịch vụ Google Ads API dễ dàng hơn.
Thư viện này yêu cầu Java 8 trở lên.
Cài đặt
Sử dụng Bảng kê khai thành phần (BOM) của Google Ads API trong tệp pom.xml hoặc build.gradle để quản lý các phiên bản phần phụ thuộc:
<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
versions of all google-ads libraries. -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads-bom</artifactId>
<version>48.0.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Add the google-ads dependency, without a version. The version is
managed by the BOM. -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
</dependency>
Bạn cũng có thể tạo thư viện từ nguồn.
Thực hiện lệnh gọi API đầu tiên
Để sử dụng Google Ads API, bạn cần thực hiện một số bước để có quyền truy cập vào API này và định cấu hình tài khoản Google Ads. Hãy làm theo hướng dẫn bắt đầu nhanh, trong đó có tất cả các bước quan trọng, bao gồm cả việc thiết lập tài khoản Google Ads.
Cách sử dụng cơ bản
Tham khảo hướng dẫn sử dụng cơ bản để tìm hiểu cách thiết lập dự án, tạo thực thể cho ứng dụng dịch vụ và chạy các ví dụ về mã bằng thư viện ứng dụng Java.
Xác thực và uỷ quyền
Thư viện ứng dụng Java hỗ trợ nhiều phương pháp xác thực và uỷ quyền, bao gồm cả quy trình ứng dụng web và ứng dụng dành cho máy tính OAuth 2.0, tài khoản dịch vụ và Thông tin xác thực mặc định của ứng dụng. Hãy tham khảo hướng dẫn xác thực và uỷ quyền để tìm hiểu thêm.
Cấu hình và ghi nhật ký
Thư viện ứng dụng Java hỗ trợ nhiều lựa chọn cấu hình (bao gồm cả tệp ads.properties, biến môi trường và cấu hình có lập trình) và các chức năng ghi nhật ký để theo dõi các yêu cầu và phản hồi của API.
Tiện ích
Thư viện ứng dụng Java bao gồm các lớp tiện ích để cải thiện khả năng hữu dụng của API. Hãy tham khảo các hướng dẫn sau để tìm hiểu thêm:
- FieldMasks: Trình trợ giúp để tạo và tính toán mặt nạ trường cập nhật.
- ResourceNames: Tiện ích để định dạng các chuỗi tên tài nguyên thực thể.
- Các thao tác diễn ra trong thời gian dài: Các trợ lý để theo dõi và quản lý các thao tác API không đồng bộ.
Tinh chỉnh ứng dụng
Tham khảo hướng dẫn sử dụng nâng cao để biết các đề xuất về cách tinh chỉnh thời gian chờ, chế độ cài đặt thử lại, độ trễ khởi động và quản lý phần phụ thuộc của ứng dụng.