OAuth2 Playground là một công cụ mạnh mẽ giúp bạn tạo mã thông báo OAuth2 cho Google Ads một cách thủ công, đặc biệt hữu ích cho những người dùng chỉ cần truy cập một tài khoản quảng cáo hoặc tài khoản người quản lý duy nhất. Nếu bạn đang tìm kiếm cách để định cấu hình thông tin xác thực OAuth2 trong API Google Ads, bài viết này sẽ hướng dẫn chi tiết từng bước quy trình sử dụng OAuth2 Playground và các thông tin cần thiết để tích hợp vào hệ thống quản lý quảng cáo của bạn.
Một phương án khác để tạo thông tin xác thực OAuth2 là sử dụng OAuth2 Playground. Đây là công cụ cho phép người dùng tạo mã thông báo OAuth2 theo phương thức thủ công, đồng thời hỗ trợ tích hợp với Bảng điều khiển API của Google.
OAuth2 Playground phù hợp cho những người dùng chỉ cần truy cập vào một tài khoản người quản lý duy nhất hoặc tài khoản Google Ads. Nếu có nhu cầu quản lý nhiều người dùng hoặc cần thông tin đăng nhập phức tạp hơn, bạn nên định cấu hình thư viện ứng dụng OAuth trong API Google Ads để quản lý toàn diện.
Nhận mã ứng dụng khách và mật khẩu ứng dụng khách
Lưu ý: Để sử dụng OAuth2 Playground, bạn phải tạo mã ứng dụng khách cho một ứng dụng web. Đây là loại ứng dụng duy nhất tương thích với OAuth2 Playground. Nếu bạn chưa có dự án nào trên đám mây, hãy thực hiện các bước sau:
- Mở trang Thông tin đăng nhập trong Bảng điều khiển API của Google.
- Trong trình đơn thả xuống của dự án, chọn dự án hiện có hoặc tạo dự án mới nếu cần.
- Trên trang Thông tin xác thực, chọn “Tạo thông tin xác thực,” sau đó chọn “Mã ứng dụng khách OAuth.”
- Trong phần Loại ứng dụng (Application type), chọn “Ứng dụng web” (Web application).
- Thêm URI chuyển hướng được phép là: https://developers.google.com/oauthplayground
- Nhấp vào Tạo.
- Sau khi hoàn tất, bạn sẽ nhận được mã ứng dụng khách và mật khẩu ứng dụng khách. Lưu lại các thông tin này, vì bạn sẽ cần sử dụng chúng trong các bước tiếp theo.
Nếu bạn đã có sẵn dự án trên đám mây, bạn có thể tiếp tục sử dụng dự án đó bằng cách thêm URI chuyển hướng được phép như hướng dẫn trên.
Tạo mã thông báo OAuth2
Tạo mã thông báo OAuth2 là một bước quan trọng trong việc tích hợp Google Ads với các ứng dụng của bạn. Dưới đây là quy trình chi tiết để tạo mã thông báo, sử dụng OAuth2 Playground.
Cảnh báo: Tài khoản Google bạn đang đăng nhập trong trình duyệt sẽ xác định tài khoản Google Ads mà bạn có thể truy cập bằng thông tin đăng nhập OAuth2 đã tạo. Do đó, bạn nên thực hiện quy trình này trong cửa sổ ẩn danh hoặc đảm bảo rằng bạn không đăng nhập vào tài khoản Google không phù hợp, vì tài khoản đăng nhập sẽ ảnh hưởng đến mã ứng dụng khách và khóa bí mật bạn sử dụng.
- Truy cập OAuth2 Playground (liên kết này sẽ điền sẵn một số giá trị cần thiết cho bạn).
- Nhấp vào biểu tượng bánh răng ở góc trên bên phải, sau đó 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 hộp chưa được đánh dấu.
- Đảm bảo các thiết lập sau:
- Quy trình OAuth được đặt thành “Phía máy chủ.”
- Loại truy cập được đặt thành “Ngoại tuyến” (bạn sẽ nhận được cả mã làm mới và mã truy cập thay vì chỉ mã truy cập).
- Nhập mã ứng dụng khách OAuth2 và mật khẩu ứng dụng khách mà bạn đã tạo trước đó.
- Trong mục “Bước 1 – Chọn và ủy quyền API,” chọn API Google Ads từ danh sách, sau đó chọn phạm vi của API là: https://www.googleapis.com/auth/adwords. Nhấp vào “Ủy 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. Nếu không, xác nhận rằng người dùng Google hiện tại ở góc trên cùng bên phải là tài khoản Google Ads hoặc tài khoản người quản lý mà bạn cần truy cập.
- Nếu bạn gặp lỗi “chuyển hướng_uri_mismatch” ngay sau khi nhận mã ứng dụng khách và mật khẩu, có thể là do thay đổi chưa được áp dụng. Hãy nhấp vào nút quay lại trong trình duyệt, đợi vài phút rồi thử lại việc ủy quyền API.
- Trong trường hợp gặp lỗi liên quan đến quyền truy cập do ứng dụng chưa được phê duyệt, bạn cần truy cập vào trang màn hình cấp phép 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 mình vào danh sách người dùng thử nghiệm.
- Một lời nhắc sẽ xuất hiện yêu cầu bạn cấp quyền cho ứng dụng quản lý chiến dịch Google Ads. Nhấp vào “Chấp nhận” để tiếp tục.
- Ở thẻ “Bước 2 – Mã ủy quyền trao đổi cho mã thông báo,” mã ủy quyền sẽ xuất hiện. Nhấp vào “Exchange” để đổi mã ủy quyền lấy mã thông báo.
- Nếu quá trình thành công, bạn sẽ nhận được mã làm mới và mã truy cập. Mở rộng lại thẻ “Bước 2” để sao chép mã thông báo.
- Sao chép mã làm mới vào tệp cấu hình thư viện ứng dụng khách của bạn, cùng với ID ứng dụng khách và mật khẩu ứng dụng khách.
Cuối cùng, bạn cần định cấu hình thư viện ứng dụng OAuth trong API Google Ads để sử dụng mã thông báo đã tạo. Điều này đảm bảo quá trình tích hợp với Google Ads diễn ra suôn sẻ và bảo mật.
Xoá OAuth2 Playground khỏi URI chuyển hướng trong mã ứng dụng khách của bạn
Sau khi bạn đã nhận được mã làm mới, OAuth2 Playground sẽ không còn cần thiết làm URI chuyển hướng được uỷ quyền nữa. Để xoá URI này khỏi danh sách các URI chuyển hướng được phép, hãy làm theo các bước sau:
- Truy cập trang “Thông tin đăng nhập” trong Bảng điều khiển API của Google.
- Tại trình đơn thả xuống dự án, chọn dự án mà bạn đang sử dụng.
- Trên trang Thông tin đăng nhập, nhấp vào tên của ứng dụng khách mà bạn muốn chỉnh sửa.
- Tìm và xoá URI chuyển hướng https://developers.google.com/oauthplayground khỏi danh sách các URI được phép. Lưu ý rằng ít nhất một URI chuyển hướng phải được giữ lại trong danh sách.
- Cuối cùng, nhấp vào “Lưu” để hoàn tất quá trình.
Sử dụng OAuth2 Playground để tạo mã thông báo OAuth2 là một phương pháp hiệu quả và dễ tiếp cận cho những ai đang quản lý Google Ads. Việc thực hiện đúng các bước từ tạo mã ứng dụng khách, mã làm mới cho đến việc xác thực thông tin sẽ giúp quá trình tích hợp API Google Ads trở nên suôn sẻ và bảo mật. Đừng quên xóa URI OAuth2 Playground sau khi bạn đã hoàn thành việc tạo mã làm mới, để đảm bảo tính an toàn và tối ưu hóa quá trình sử dụng Google Ads của bạn.
