API Báo cáo Search Ads 360 mới hiện đã ra mắt. Tham gia nhóm Google searchads-api-announcements để luôn được cập nhật về những cải tiến và bản phát hành sắp tới.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Một cách để tạo thông tin xác thực OAuth2 là sử dụng OAuth2
Playground. OAuth2 Playground, kết hợp với bảng điều khiển API Google Ads, cho phép bạn tạo mã thông báo OAuth2 theo cách thủ công.
OAuth2 Playground dành cho những người dùng chỉ cần truy cập vào tài khoản của một tài khoản người quản lý hoặc người dùng Google Ads. Nếu cần nhắc nhiều người dùng cung cấp thông tin xác thực, bạn nên định cấu hình thư viện ứng dụng cho OAuth trong Search Ads 360.
Nhận mã ứng dụng khách và khoá bí mật của ứng dụng khách
Trong trình đơn thả xuống về dự án, hãy chọn một dự án hiện có hoặc tạo một dự án mới.
Trên trang Thông tin xác thực, hãy chọn Tạo thông tin xác thực, sau đó chọn Mã ứng dụng khách OAuth.
Trong mục Loại ứng dụng, hãy chọn Ứng dụng web.
Trong phần URI chuyển hướng được uỷ quyền, hãy thêm một dòng có:
https://developers.google.com/oauthplayground
Nhấp vào Tạo.
Trên trang Mã ứng dụng khách, hãy ghi lại mã ứng dụng khách và khoá bí mật của ứng dụng khách.
Bạn sẽ cần các thông tin này trong bước tiếp theo.
Nếu đã có một dự án trên đám mây, bạn có thể sử dụng lại dự án đó bằng cách đặt URI chuyển hướng được uỷ quyền như trên.
Tạo mã thông báo
Truy cập vào OAuth2
Playground (bằng cách sử dụng đường liên kết này, một số giá trị khoá sẽ được điền sẵn cho bạn).
Nhấp vào biểu tượng bánh răng ở góc trên bên phải rồi đánh dấu vào hộp có nhãn Sử dụng thông tin xác thực OAuth của riêng bạn (nếu bạn chưa đánh dấu).
Hãy chắc chắn rằng:
Quy trình OAuth được đặt thành Phía máy chủ.
Loại quyền truy cập được đặt thành Ngoại tuyến (điều này đảm bảo bạn nhận được mã làm mới và mã truy cập, thay vì chỉ nhận được mã truy cập).
Nhập mã ứng dụng khách OAuth2 và khoá bí mật ứng dụng khách OAuth2 mà bạn đã nhận được ở trên.
Trong phần có nhãn Bước 1 – Chọn và uỷ quyền API, hãy nhấp vào Search Ads 360 Reporting API trong danh sách rồi chọn phạm vi của API đó, https://www.googleapis.com/auth/doubleclicksearch. Sau đó, hãy nhấp vào Uỷ quyền API:
Nếu được nhắc, hãy đăng nhập vào tài khoản mà bạn muốn cấp quyền truy cập và uỷ quyền. Nếu không, hãy xác nhận rằng người dùng hiện tại ở góc trên cùng bên phải là tài khoản khách hàng hoặc tài khoản người quản lý mà bạn muốn lấy thông tin xác thực.
Một lời nhắc sẽ xuất hiện cho biết ứng dụng của bạn muốn Quản lý chiến dịch trên Search Ads 360. Nhấp vào Chấp nhận để tiếp tục.
Trong thẻ có nhãn Bước 2 – Trao đổi mã uỷ quyền lấy mã thông báo, Mã uỷ quyền sẽ xuất hiện. Nhấp vào Đổi mã uỷ quyền lấy mã thông báo.
Nếu mọi thứ diễn ra suôn sẻ, Mã làm mới và Mã truy cập sẽ được điền sẵn cho bạn (bạn có thể phải mở rộng lại Bước 2 – Trao đổi mã uỷ quyền lấy mã thông báo):
Sao chép Mã thông báo làm mới vào tệp cấu hình cho thư viện ứng dụng mà bạn chọn, cùng với mã ứng dụng và khoá bí mật của ứng dụng.
Giờ đây, khi đã có mã thông báo làm mới, bạn không cần OAuth2 Playground là URI chuyển hướng được uỷ quyền nữa. Cách xoá URI đó khỏi danh sách URI chuyển hướng được uỷ quyền:
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-06-04 UTC."],[[["The OAuth2 Playground enables manual creation of OAuth2 tokens for single manager account or Google Ads user access."],["To use the OAuth2 Playground, you need a client ID and client secret generated for a web application in the Google API Console."],["Generate refresh and access tokens using the OAuth2 Playground by authorizing the Search Ads 360 Reporting API."],["Configure your client library using the generated refresh token, client ID, and client secret for Search Ads 360 API access."],["After obtaining the refresh token, remove the OAuth2 Playground from the authorized redirect URIs in your Google API Console project."]]],["To generate OAuth2 credentials via the OAuth2 Playground, first create a web application client ID and secret in the Google API Console, adding `https://developers.google.com/oauthplayground` as an authorized redirect URI. Next, navigate to the OAuth2 Playground, input your credentials, and select the Search Ads 360 Reporting API scope. Authorize the API, exchange the authorization code for tokens, and copy the refresh token, client ID, and client secret to your client library configuration. Finally, remove the OAuth2 Playground URI from your authorized redirect URIs.\n"]]