Sau đây là cách sử dụng cơ bản của thư viện ứng dụng Java:
Tạo một 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ủa chúng tôi được phát hành lên kho lưu trữ trung tâm Maven.
Bạn nên sử dụng Danh sách thành phần (BOM) của Google Ads API để quản lý các phiên bản phần phụ thuộc.
Bạn cũng có thể xây dựng từ nguồn. Trong hướng dẫn này, giả định rằng bạn đã thiết lập một dự án có các phần phụ thuộc bắt buộc.
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 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 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 cuộc gọi đầu tiên
Sau khi định cấu hình thông tin đăng nhập, 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, chúng ta sẽ 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 một tham số --customerId có 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 ngang.
Cách chạy bằng Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --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ị INSERT_XXXXX_HERE trong mã nguồn. Để xem câu lệnh sử dụng cho một 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ể sử 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'