登入

Google Classroom 外掛程式必須使用 Google 單一登入 (SSO) 服務，識別及驗證使用者。

如要進一步瞭解單一登入，請參閱 Google Identity 的 OpenID Connect 指南。此外，我們也建議參考 Google 關於使用者註冊和登入的官方文件，瞭解自動登入和登入品牌宣傳規範。

如需在 Classroom 外掛程式中導入 Google SSO 的相關指引，請參閱無阻礙登入頁面。無摩擦登入指南也提到測試計畫，可確保外掛程式遵循登入最佳做法。

登入流程

為減少使用者登入時遇到的阻礙，Google Classroom 會在開啟 iframe 時提供 login_hint 查詢參數。login_hint 是使用者專屬的 Google ID，會在使用者首次登入外掛程式後提供。這個參數會提供登入 Google Classroom 的使用者相關資訊。如要進一步瞭解這些查詢參數，請參閱登入參數指南頁面。

如果目前 Google Classroom 使用者的 login_hint 查詢參數與外掛程式的任何登入使用者不符，您就必須顯示 Google 登入對話方塊。按鈕必須符合 Google 品牌宣傳指南。如果使用者已登入，系統就不會再次提示登入。

圖 1. 使用者首次啟動外掛程式時的登入流程。

重要事項： 只有在外掛程式沒有登入使用者可供與 login_hint 查詢參數比較時，才會顯示登入按鈕。如果外掛程式使用 login_hint 的值比對已登入的使用者，就不需要登入按鈕；在這種情況下，外掛程式應讓使用者保持登入狀態。