Cách dùng cơ bản

Sau đây là cách sử dụng cơ bản của thư viện ứng dụng Java:

Tạo dự án Maven hoặc Gradle mới

Tạo dự án Maven hoặc Gradle mới trong IDE mà bạn chọn. Các cấu phần phần mềm được phát hành vào kho lưu trữ trung tâm Maven.

Sử dụng Bảng kê khai thành phần (BOM) của Google Ads API để quản lý các phiên bản phần phụ thuộc.

Nếu bạn muốn chạy các ví dụ về mã được đóng gói sẵn có trong mô-đun google-ads-examples, hãy sao chép kho lưu trữ google-ads-java từ GitHub hoặc tạo từ nguồn. Nếu bạn đang tạo từ nguồn, hãy đảm bảo rằng bạn bật tính năng xử lý chú thích trong IDE.

Định cấu hình quyền truy cập API

Để kết nối với API Google Ads, bạn cần cung cấp thông tin xác thực và thông tin uỷ quyền. Hãy xem hướng dẫn Xác thực và uỷ quyền để biết thông tin chi tiết về thông tin xác thực bắt buộc và cách định cấu hình thư viện ứng dụng.

Thực hiện lệnh gọi đầu tiên

Sau khi định cấu hình thông tin xác thực, bạn đã sẵn sàng thực hiện lệnh gọi API đầu tiên.

Để xác thực thông tin xác thực và thực hiện lệnh gọi đầu tiên bằng kho lưu trữ đã sao chép google-ads-java, hãy chạy ví dụ GetCampaigns.

Trước tiên, hãy chuyển đến thư mục google-ads-examples:

cd google-ads-examples

Ví dụ này yêu cầu tham số --customerId trong đó giá trị là mã khách hàng tài khoản Google Ads của bạn mà không có dấu gạch nối (-).

Cách chạy bằng Gradle:

./gradlew -q runExample \
  --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

Cách chạy bằng Maven:

mvn exec:java \
  -Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
  -Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"

Khám phá các ví dụ khác

Gói ví dụ trong google-ads-examples chứa một số ví dụ hữu ích. Hầu hết các ví dụ đều yêu cầu tham số. Bạn có thể truyền các tham số dưới dạng đối số (nên dùng) hoặc chỉnh sửa các giá trị phần giữ chỗ INSERT_..._HERE trong mã nguồn. Để xem câu lệnh sử dụng cho một ví dụ, hãy chuyển --help làm đối số duy nhất.

Với Gradle:

./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

Bạn cũng có thể sử dụng tác vụ listExamples trong Gradle để liệt kê tất cả ví dụ, ví dụ trong thư mục con hoặc ví dụ có phần mô tả chứa cụm từ tìm kiếm:

# List all examples:
./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
./gradlew -q listExamples --searchTerm='Performance Max'