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ấu phần phần mềm của chúng tôi xuất bản lên Trung tâm Maven kho lưu trữ.
Phần phụ thuộc Maven là:
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
<version>33.0.0</version>
</dependency>
Phần phụ thuộc Gradle là:
implementation 'com.google.api-ads:google-ads:33.0.0'
Bạn cũng có thể tạo từ nguồn. Để đạt được mục đích này, 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 sẵn có.
Lấy thông tin đăng nhập để xác thực với API
Để truy cập vào API Google Ads, bạn phải có thông tin đăng nhập OAuth và nhà phát triển API Google Ads mã thông báo. Phần này giải thích định nghĩa, cách sử dụng và cách sử dụng thu được.
Mã của người 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 người quản lý tài khoản 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 tài khoản người quản lý, nhưng mã này không cung 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)
Để 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 đăng nhập OAuth.
Có hai quy trình OAuth thường được sử dụng: ứng dụng dành cho máy tính (đã cài đặt) hoặc ứng dụng web. Điểm khác biệt chính giữa hai ứng dụng này 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 người dùng trình duyệt của bên thứ ba để hoàn tất quy trình uỷ quyền và gửi lại thông tin đăng nhập cho máy chủ của bạn. Thư viện này cũng hỗ trợ tài khoản dịch vụ ít được sử dụng hơn luồng.
- Nếu bạn cho phép bằng thông tin đăng nhập của riêng mình (quy trình trong ứng dụng dành cho máy tính)
- Tham khảo ứng dụng OAuth dành cho máy tính để bàn quy trình. Trong đó có tất cả thông tin chi tiết mà bạn cần cấp phép bằng thông tin xác thực của riêng mình.
- Nếu bạn cho phép với tư cách là người dùng Google bên thứ ba (luồng web)
- Tham khảo quy trình ứng dụng web OAuth. Chiến dịch này đưa ra ví dụ về cách thiết lập phương thức uỷ quyền OAuth cho bên thứ ba tuỳ ý người dùng mới.
- Nếu bạn cho phép với tư cách là người dùng Miền Google Apps (luồng tài khoản dịch vụ)
- Tham khảo tài khoản dịch vụ OAuth quy trình. Đây là một ví dụ về cách thiết lập ủy quyền OAuth cho người dùng miền Google Apps.
Nếu bạn có quyền truy cập vào tài khoản khách hàng Google Ads thông qua một người quản lý Google Ads tài khoản, bạn cũng phải chỉ định ID khách hàng đăng nhập như được 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ý)
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 quảng cáo. Bạn phải chỉ định giá trị này nếu quyền truy cập của bạn vào tài khoản khách hàng thông qua tài khoản người quản lý. Không cần chỉ định tất cả người quản lý trên đường dẫn đến mã khách hàng, chỉ có mã người quản lý cấp cao nhất mà bạn đang dùng để cấp quyền truy cập. Để biết thêm chi tiết, hãy xem bài viết .
Đị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 tệp cấu hình, biến môi trường hay theo phương thức lập trình. Trong hướng dẫn này, chúng tôi sẽ sử dụng tệp cấu hình và tập trung vào luồng máy tính và luồng web. Sử dụng thường là một phương pháp hiệu quả nếu bạn chỉ có một tập hợp 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 xác thực của bạn có được ở bước trước.
Ngoài ra, nếu mã 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 ID 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 chiến dịch GetCampaigns ví dụ.
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à của bạn
Mã khách hàng của tài khoản Google Ads không có dấu gạch ngang.
Để chạy với Gradle:
$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Khám phá các ví dụ khác
Gói ví dụ trong google-ads-examples
chứa vài 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 tuyên bố về mức sử dụng
chẳng hạn như 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 thư mục con hoặc các ví dụ trong đó mô tả bao gồm một tìm kiếm
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'