Vì trải nghiệm đăng nhập là lượt tương tác đầu tiên mà người dùng có thể có với tiện ích bổ sung của bạn, nên điều quan trọng là họ có thể hoàn tất quy trình này một cách liền mạch nhất có thể. Hãy đọc các phần bên dưới để làm quen với nhiều API đăng nhập, tham số truy vấn liên quan đến việc đăng nhập, cách xử lý trình chặn cửa sổ bật lên và kế hoạch kiểm thử mà bạn có thể sử dụng trong quá trình phát triển để đảm bảo bạn đang tuân thủ các phương pháp hay nhất.
Thông tin chi tiết về việc triển khai tính năng đăng nhập một lần (SSO)
OAuth 2.0 của Google tương thích với nhiều ngăn xếp OAuth 2.0. Bạn nên triển khai hoạt động uỷ quyền phía máy chủ vì đây là lựa chọn bảo mật cao nhất và hỗ trợ việc sử dụng các tham số truy vấn iframe.
Hãy tham khảo hướng dẫn kỹ thuật có trên trang web Google Identity khi triển khai tính năng đăng nhập bằng Google. Hãy nhớ tuân thủ nguyên tắc sử dụng thương hiệu khi đăng nhập bằng Google. Bạn có thể tải các tệp Sketch, SVG và EPS xuống.
Kiểm thử đăng nhập
Sử dụng kế hoạch kiểm thử của tiện ích bổ sung để kiểm tra xem tiện ích bổ sung của bạn có đáp ứng các tiêu chuẩn bắt buộc và có thể xử lý các trường hợp biên đã biết hay không trước khi bạn gửi tiện ích bổ sung đi xem xét. Các bài kiểm thử này phản ánh chính xác danh sách kiểm tra yêu cầu đối với tiện ích bổ sung cho Lớp học và cung cấp cho bạn hướng dẫn từng bước về cách kiểm tra xem tiện ích bổ sung của bạn có đáp ứng những yêu cầu đó hay không. Đây là những kiểm thử tương tự mà ứng dụng của bạn sẽ được kiểm thử trong quá trình xuất bản.
Tham số truy vấn đăng nhập
Google Lớp học cung cấp tham số truy vấn login_hint để giúp tạo điều kiện thuận lợi cho việc đăng nhập nhiều lần. Hãy xem phần về các tham số liên quan đến việc đăng nhập trên trang tham số truy vấn iframe để biết thêm thông tin. Bạn có thể tìm thấy mã mẫu trong hướng dẫn xử lý lượt truy cập lặp lại trong hướng dẫn dành cho nhà phát triển của chúng tôi.
Quản lý trình chặn cửa sổ bật lên
Việc đăng nhập vào tiện ích bổ sung được thực hiện thông qua cửa sổ hộp thoại đăng nhập. Cửa sổ này hiển thị màn hình bộ chọn tài khoản và cho phép người dùng cấp quyền OAuth. Trình chặn cửa sổ bật lên của người dùng cuối có thể ngăn họ hoàn tất quy trình đăng nhập.
Hình 1. Ví dụ về một màn hình bộ chọn tài khoản.
Để giải quyết vấn đề này, hãy cung cấp cho người dùng cuối một nút để nhấp vào nhằm bỏ qua trình chặn cửa sổ bật lên. Tương tác này cho phép hộp thoại đăng nhập xuất hiện để người dùng cuối có thể tiếp tục quy trình đăng nhập. Đảm bảo rằng nút mà bạn cung cấp tuân thủ nguyên tắc sử dụng thương hiệu khi đăng nhập.
Làm theo hướng dẫn đăng nhập trong hướng dẫn dành cho nhà phát triển của chúng tôi để triển khai một nút đăng nhập mang thương hiệu Google. Người dùng có thể nhấp vào nút này để kích hoạt hộp thoại đăng nhập.
Đăng nhập nhiều tài khoản
Trình duyệt có nhiều tài khoản đăng nhập cùng lúc có thể làm gián đoạn quy trình người dùng của tiện ích bổ sung. Người dùng cuối có thể đăng xuất khỏi tất cả Tài khoản Google trong trình duyệt hiện tại hoặc mở Lớp học trong cửa sổ Chrome ẩn danh trước khi đăng nhập bằng tài khoản chính xác và thử lại thao tác.
Nếu một người dùng không chính xác đăng nhập vào tiện ích bổ sung do vấn đề đăng nhập nhiều lần, thì các lệnh gọi của bạn đến API tiện ích bổ sung Lớp học có thể không thành công kèm theo lỗi InvalidAddOnToken. Nếu gặp phải lỗi này, bạn nên hướng dẫn người dùng đăng xuất khỏi tất cả các tài khoản khác trong trình duyệt hoặc mở Classroom trong cửa sổ Chrome ở chế độ ẩn danh.