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 một 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 lên kho lưu trữ Maven Central.

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 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ú giải trong IDE.

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

Để kết nối với Google Ads API, bạn cần cung cấp thông tin xác thực và 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 đăng nhập bắt buộc và cách định cấu hình thư viện ứng dụng.

Thực hiện cuộc 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 đăng nhập và thực hiện lệnh gọi đầu tiên bằng kho lưu trữ google-ads-java được sao chép, 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 không có dấu gạch ngang (-).

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 examples 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 một câu lệnh sử dụng cho ví dụ, hãy truyề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ể dùng tác vụ listExamples trong Gradle để liệt kê tất cả các ví dụ, ví dụ trong một thư mục con hoặc ví dụ có nội dung mô tả bao gồm một 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'