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 đăng nhập dễ dàng hơn và tạo ứng dụng dịch vụ Google Ads API.
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>46.1.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
Thư viện video: Bắt đầu sử dụng thư viện ứng dụng Java
Để 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 và định cấu hình tài khoản Google Ads. Làm theo hướng dẫn bắt đầu nhanh. Hướng dẫn này sẽ chỉ cho bạn tất cả các bước quan trọng, bao gồm cả cách 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, khởi tạo ứ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à ủy quyền, bao gồm cả quy trình ứng dụng web và 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 theo chương trình) cũng như các chức năng ghi nhật ký để theo dõi các yêu cầu và phản hồi 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 sử dụng API. Hãy tham khảo các hướng dẫn sau để tìm hiểu thêm:
- FieldMasks: Các đối tượng hỗ trợ để tạo và tính toán mặt nạ cho 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
Hãy 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à hoạt động quản lý phần phụ thuộc của ứng dụng.