Playground OAuth

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à mật khẩu ứng dụng khách

Cảnh báo: Để sử dụng OAuth2 Playground, bạn cần tạo mã ứng dụng khách cho ứng dụng web. Đây là loại ứng dụng duy nhất hoạt động với OAuth2 Playground. Hãy tham khảo phần Chọn loại ứng dụng để biết thêm thông tin.

Nếu bạn chưa có dự án nào trên đám mây:

1. Mở trang Thông tin xác thực trong Google API Console.

2. 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.

3. 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.

4. Trong mục Loại ứng dụng, hãy chọn Ứng dụng web.

5. 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

6. Nhấp vào Tạo.

7. Trên trang Mã ứng dụng khách, hãy ghi lại mã ứng dụng khách và mật khẩu ứng dụng khách. Bạn sẽ cần các tệp 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

Cảnh báo: Người dùng Search Ads 360 mà bạn đăng nhập trong trình duyệt sẽ xác định tài khoản mà bạn có thể truy cập bằng thông tin xác thực OAuth2 mà bạn tạo. Do đó, bạn nên thực hiện các bước này trong một cửa sổ ẩn danh hoặc khi bạn chưa đăng nhập vào tài khoản Search Ads 360, vì có thể người dùng mà bạn muốn sử dụng thông tin xác thực không phải là người dùng mà bạn đã đăng nhập khi nhận mã ứng dụng và mã xác thực.

1. 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).

2. Nhấp vào biểu tượng bánh răng ở góc trên bên phải rồi chọn hộp có nhãn Use your own OAuth credentials (Sử dụng thông tin đăng nhập OAuth của riêng bạn) (nếu bạn chưa đánh dấu).

3. Hãy chắc chắn rằng:

   • Quy trình của 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).

4. 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.

   

5. 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 (API Báo cáo Search Ads 360) 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:

   

6. 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.

   Nếu bạn đã nhận được mã ứng dụng khách và mật khẩu bí mật chỉ vài phút trước đây thì bạn gặp lỗi như Error: Redirect_uri_mismatch, thì có thể những thay đổi bạn đã thực hiện chưa được áp dụng. Nhấp vào nút quay lại trong trình duyệt, đợi vài phút rồi thử nhấp lại vào Uỷ quyền API.
   Nếu gặp lỗi rằng bạn chưa được nhà phát triển cấp quyền truy cập và ứng dụng hiện đang được kiểm thử, bạn sẽ cần truy cập vào trang màn hình xin phép bằng OAuth trong dự án GCP và thực hiện một trong những thao tác sau:

   • Xuất bản ứng dụng.

   • Giữ ứng dụng ở trạng thái Thử nghiệm và tự thêm bạn làm người dùng thử nghiệm.

7. 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.

8. 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.

   

9. 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):

   

10. 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.

11. Định cấu hình thư viện ứng dụng cho OAuth trong API Báo cáo Search Ads 360.

Xoá OAuth2 Playground khỏi mã ứng dụng khách của bạn

Giờ đây khi đã có mã làm mới, bạn không cần OAuth2 Playground làm 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:

1. Chuyển đến trang Thông tin xác thực trên Google API Console.

2. Trong trình đơn thả xuống dự án, hãy chọn dự án của bạn.

3. Trên trang Thông tin xác thực, hãy nhấp vào tên mã ứng dụng để chỉnh sửa.

4. Xoá https://developers.google.com/oauthplayground khỏi URI chuyển hướng được uỷ quyền. Xin lưu ý rằng bạn phải giữ lại ít nhất một URI chuyển hướng.

5. Nhấp vào Lưu.