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 lựa chọn để tạo thông tin đăng nhập OAuth2 là sử dụng OAuth2 Playground. OAuth2 Playground, cùng với bảng điều khiển Google Ads API, 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 cho một tài khoản người quản lý duy nhất 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 đăng nhập, thì 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 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 OAuth.
Trong mục Loại ứng dụng, hãy chọn Ứng dụng web.
Trong mục 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 những thông tin này trong bước tiếp theo.
Nếu đã có một dự á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 (việc sử dụng đường liên kết này sẽ điền sẵn một số giá trị khoá 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 ô có nhãn Sử dụng thông tin đăng nhập OAuth của riêng bạn (nếu chưa được đá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 OAuth2 và khoá bí mật của ứng dụng 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 cho API:
Nếu thấy lời 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 đăng nhập.
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 – Đổ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 – Đổi mã uỷ quyền lấy mã thông báo):
Sao chép Mã làm mới vào tệp cấu hình cho thư viện ứng dụng khách mà bạn chọn, cùng với mã ứng dụng khách và khoá bí mật của ứng dụng khách.
Giờ đây, khi đã có mã làm mới, bạn không cần OAuth2 Playground phải là URI chuyển hướng được uỷ quyền nữa. Cách xoá URI chuyển hướng đó 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-09-03 UTC."],[[["\u003cp\u003eThe OAuth2 Playground enables manual creation of OAuth2 tokens for single manager account or Google Ads user access.\u003c/p\u003e\n"],["\u003cp\u003eTo use the OAuth2 Playground, you need a client ID and client secret generated for a web application in the Google API Console.\u003c/p\u003e\n"],["\u003cp\u003eGenerate refresh and access tokens using the OAuth2 Playground by authorizing the Search Ads 360 Reporting API.\u003c/p\u003e\n"],["\u003cp\u003eConfigure your client library using the generated refresh token, client ID, and client secret for Search Ads 360 API access.\u003c/p\u003e\n"],["\u003cp\u003eAfter obtaining the refresh token, remove the OAuth2 Playground from the authorized redirect URIs in your Google API Console project.\u003c/p\u003e\n"]]],["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"],null,[]]