Bạn nên sử dụng thư viện ứng dụng với Apache Maven (hoặc Gradle).
Tạo dự án Maven/Gradle mới
Tạo một dự án Maven/Gradle mới trong IDE mà bạn chọn. Cấu phần phần mềm của chúng tôi được phát hành vào kho lưu trữ trung tâm Maven.
Phần phụ thuộc Maven là:
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
<version>36.0.0</version>
</dependency>
Phần phụ thuộc Gradle là:
implementation 'com.google.api-ads:google-ads:36.0.0'
Bạn cũng có thể tạo từ nguồn. Đối với mục đích của hướng dẫn này, giả định rằng bạn đã thiết lập dự án có các phần phụ thuộc bắt buộc.
Lấy thông tin xác thực để xác thực bằng API
Để truy cập vào API Google Ads, bạn cần có thông tin xác thực OAuth và mã của nhà phát triển API Google Ads. Phần này giải thích về các giá trị này, cách sử dụng và cách lấy.
Mã của nhà phát triển (để truy cập vào API)
Mã thông báo dành cho nhà phát triển được liên kết với tài khoản quản lý và có trong giao diện web của Google Ads.
Mặc dù mã của nhà phát triển được liên kết với tài khoản người quản lý, nhưng mã này không cấp quyền truy cập vào tài khoản đó. Thay vào đó, mã thông báo dành cho nhà phát triển cấp quyền truy cập vào API nói chung và quyền truy cập cấp tài khoản được định cấu hình thông qua OAuth.
Thông tin xác thực OAuth (để truy cập vào tài khoản Google Ads)
Để uỷ quyền với tư cách là người dùng Tài khoản Google có quyền truy cập vào tài khoản Google Ads, bạn phải cung cấp một bộ thông tin xác thực OAuth.
Có hai luồng OAuth thường được sử dụng: ứng dụng máy tính để bàn (đã cài đặt) hoặc ứng dụng web. Điểm khác biệt chính giữa hai luồng này là ứng dụng máy tính để bàn phải mở trình duyệt hệ thống và cung cấp URI chuyển hướng cục bộ để xử lý các phản hồi từ máy chủ uỷ quyền của Google, trong khi ứng dụng web có thể chuyển hướng một trình duyệt bên thứ ba tuỳ ý để hoàn tất việc uỷ quyền và gửi thông tin xác thực trở lại máy chủ của bạn. Thư viện này cũng hỗ trợ luồng tài khoản dịch vụ ít được sử dụng hơn.
- Nếu bạn cho phép sử dụng thông tin xác thực của riêng mình (quy trình ứng dụng dành cho máy tính)
- Tham khảo quy trình ứng dụng máy tính OAuth. Thông tin này bao gồm tất cả thông tin chi tiết bạn cần để uỷ quyền bằng thông tin xác thực của riêng mình.
- Nếu bạn uỷ quyền với tư cách là người dùng Google bên thứ ba (quy trình trên web)
- Tham khảo quy trình ứng dụng web OAuth. Đây là ví dụ về cách thiết lập quyền uỷ quyền OAuth cho người dùng bên thứ ba tuỳ ý.
- Nếu bạn uỷ quyền với tư cách là người dùng miền Google Apps (quy trình tài khoản dịch vụ)
- Tham khảo quy trình tài khoản dịch vụ OAuth. Đây là ví dụ về cách thiết lập quyền uỷ quyền OAuth cho người dùng Miền Google Apps.
Nếu truy cập vào tài khoản khách hàng Google Ads thông qua tài khoản người quản lý Google Ads, bạn cũng phải chỉ định mã khách hàng đăng nhập như mô tả bên dưới.
Mã khách hàng đăng nhập (để truy cập vào tài khoản Google Ads thông qua tài khoản người quản lý)
Bạn có thể chỉ định mã khách hàng của tài khoản người quản lý để cấp quyền truy cập vào tài khoản phân phát. Bạn phải chỉ định thông tin này nếu truy cập vào tài khoản khách hàng thông qua tài khoản người quản lý. Bạn không cần chỉ định tất cả tài khoản người quản lý trên đường dẫn đến mã khách hàng, chỉ cần mã người quản lý cấp cao nhất mà bạn đang sử dụng cho quyền truy cập. Để biết thêm thông tin chi tiết, hãy xem tài liệu liên quan.
Định cấu hình thư viện ứng dụng bằng thông tin xác thực của bạn
Bạn có thể định cấu hình thư viện ứng dụng bằng tệp cấu hình, biến môi trường hoặc lập trình. Trong hướng dẫn này, chúng ta sẽ sử dụng phương pháp tệp cấu hình và tập trung vào quy trình trên máy tính và web. Việc sử dụng tệp cấu hình thường là một phương pháp hay nếu bạn chỉ có một bộ thông tin xác thực (ví dụ: bạn quản lý các tài khoản trong một người quản lý).
Tạo tệp ~/ads.properties có nội dung sau:
api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
Thay thế phần giữ chỗ bằng thông tin xác thực mà bạn đã nhận được ở bước trước.
Ngoài ra, nếu mã thông báo làm mới của bạn là dành cho tài khoản người quản lý, bạn nên chỉ định mã khách hàng của tài khoản này làm khách hàng đăng nhập:
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE
Xác thực thông tin xác thực
Để đảm bảo mọi thứ được thiết lập đúng cách, chúng ta sẽ chạy ví dụ về 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 thông số --customerId, trong đó giá trị là mã khách hàng của tài khoản Google Ads 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 (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ị INSERT_XXXXX_HERE trong mã nguồn. Để xem 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ể sử dụng tác vụ listExamples trong Gradle để liệt kê tất 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'