登入

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

如要進一步瞭解單一登入 (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 的值與登入的使用者相符，就不一定要登入按鈕。在此情況下，外掛程式應讓使用者保持登入狀態。

重點提示： 除了管理員安裝作業外，外掛程式也可以允許個人進行安裝。

個人安裝會將外掛程式新增至使用者的帳戶。個別安裝外掛程式時，系統會提示使用者同意外掛程式的存取權範圍。

「管理員安裝」會將外掛程式新增至網域中的任何或所有帳戶，且只有網域管理員才能執行此操作。管理員可以視需要代表網域中所有使用者同意所有存取權範圍；如果管理員選擇這麼做，使用者就不會收到同意任何存取權範圍的提示。

詳情請參閱安裝設定。