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

Google thực hiện lệnh gọi đến các điểm cuối OAuth2 của bạn trong quá trình liên kết tài khoản. Các lệnh gọi này có thể không thành công 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 các lỗi đó trong trang Trình khám phá nhật ký của dự án trên Cloud Console.

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 như sau rồi nhấp vào nút Run Query (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 Bảng điều khiển Actions on Google; nếu không, hãy chọn tuỳ chọn Dự án Google.
  • Tên nhật ký: Chọn tuỳ 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 của Trình khám phá nhật ký

Bạn có thể tìm 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 lỗi liên kết tài khoản nằm trong thuộc tính jsonPayload của mục nhập lỗi. Dữ liệu này 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 chưa 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ã 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 bằng câu nhận định.
  • response (String, optional): Biểu thị phản hồi HTTP:
    • status: Trạng thái của phản hồi HTTP.
    • body: Nội dung 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 tham số yêu cầu HTTP sau đây: phương thức, nội dung, URI và tiêu đề.

Bạn không bắt buộc phải sử dụng các trường request và response vì đôi khi các trường này được 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 tinh giản, 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. Giá trị bạn trả về phải tương ứng với trạng thái chính xác được liệt kê trong tài liệu.