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