Giám sát lỗi Liên kết tài khoản trong dự án Google Console của bạn

Google sẽ gọi điện đến các điểm cuối OAuth2 của bạn trong quá trình liên kết tài khoản. Những lệnh gọi này có thể không thực hiện được vì nhiều lý do. Thông tin chi tiết được ghi lại cho các lỗi này và bạn có thể theo dõi chúng trong trang Nhật ký khám phá của dự án bảng điều khiển đám mây của bạn.

Lọc để tìm lỗi Liên kết tài khoản

Trên trang Trình khám phá nhật ký, hãy đặt bộ lọc truy vấn thành nội dung sau đây và nhấp vào nút Chạy truy vấn:

  • Tài nguyên: Chọn Dự án hành động của Trợ lý Google nếu bạn đã tạo dự án thông qua Hành động trên Google Console; nếu không, hãy chọn tùy chọn Dự án Google.
  • Tên nhật ký: Chọn tùy chọn Lỗi Liên kết Tài khoản Google.
  • Mức độ nghiêm trọng: Đặt thành lỗi; tất cả các mục liên kết tài khoản đều được phân loại là lỗi.

Bạn cũng có thể lọc theo ngày bằng cách cập nhật phạm vi thời gian ở đầu trang Trình khám phá nhật ký, như trong ảnh chụp màn hình sau:

Hình 1 Bộ lọc truy vấn Trình khám phá nhật ký

Bạn có thể xem thêm thông tin về cách sử dụng Trình khám phá nhật ký trong tài liệu về Trình khám phá nhật ký.

Nội dung của dữ liệu lỗi

Dữ liệu về lỗi liên kết tài khoản có trong thuộc tính jsonPayload của mục lỗi. Dữ liệu bao gồm các trường sau:

  • @type (String): Luôn đặt thành type.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.
  • step (String): Bước liên kết mà lỗi xảy ra. Đặt thành một trong các giá trị sau:
    • ACCOUNT_LINKING_STEP_UNDEFINED: Một bước không xác định.
    • AUTH_CODE_EXCHANGE: Bước trao đổi mã xác thực để truy cập hoặc làm mới mã thông báo.
    • REFRESH_ACCESS_TOKEN: Bước để làm mới mã thông báo truy cập.
    • TOKEN_REVOCATION: Bước thu hồi mã thông báo.
    • USERINFO: Bước tìm nạp thông tin người dùng bằng mã truy cập.
    • ASSERTION: Bước tạo đường liên kết theo câu nhận định.
  • response (String, optional): Biểu thị một phản hồi HTTP:
    • status: Trạng thái của phản hồi HTTP.
    • body: Mô tả lỗi và chuỗi lỗi.
  • request (String, optional): Biểu thị một yêu cầu HTTP và chứa các thông số yêu cầu HTTP sau: phương thức, nội dung, URI và tiêu đề.

Các trường request và response là không bắt buộc vì đôi khi chúng được phân tách thành 2 mục nhập khác nhau trong trình xem nhật ký.

Khi triển khai máy chủ OAuth liên kết tài khoản Google và máy chủ OAuth liên kết tài khoản Google được đơn giản hóa, bạn phải sử dụng mã phản hồi HTTP cụ thể cho các trạng thái khác nhau. Các giá trị bạn trả về phải tương ứng với trạng thái chính xác được nêu trong tài liệu.