順暢登入

由於登入體驗是使用者首次與外掛程式的互動,因此請務必讓使用者能盡可能順暢完成整個流程。請參閱下列各節,瞭解各種登入 API、登入相關查詢參數、如何處理彈出式視窗攔截器,以及可在開發期間使用的測試計畫,以確保您遵循最佳做法。

SSO 實作詳情

Google 的 OAuth 2.0 與許多 OAuth 2.0 堆疊相容。我們強烈建議您導入伺服器端授權,因為這是安全性最高的選項,而且支援使用 iframe 查詢參數

在實作 Google 登入功能時,請參閱 Google Identity 網站提供的技術指南。請務必遵守 Google 登入品牌宣傳指南。我們提供草圖、SVG 和 EPS 檔案供你下載。

登入測試

先使用外掛程式測試計畫來檢查外掛程式是否符合所需標準,並且能夠處理已知的極端案例,然後再將外掛程式送交審查。這些測試與 Classroom 外掛程式需求檢查清單密切相關,並提供逐步操作說明,協助您檢查外掛程式是否符合這些需求條件。這和應用程式在發布期間測試的測試相同。

登入查詢參數

Google Classroom 提供 login_hint 查詢參數,可協助您執行重複登入程序。詳情請參閱 iframe 查詢參數頁面的登入相關參數一節。您可以在開發人員逐步操作說明的重複造訪步驟中找到程式碼範例。

管理彈出式視窗攔截器

透過登入對話方塊視窗登入外掛程式。這個視窗會顯示帳戶選取器畫面,並允許使用者授予 OAuth 權限。使用者的彈出式視窗攔截器可能會妨礙使用者完成登入流程。

帳戶選取器畫面範例

圖 1 帳戶選取器畫面範例。

如要解決這個問題,請提供使用者點選按鈕即可略過彈出式視窗攔截器。這項互動可讓系統顯示登入對話方塊,讓使用者可以繼續登入流程。請確定您提供的按鈕符合登入品牌宣傳指南

按照開發人員逐步操作說明中的登入逐步操作說明,實作 Google 品牌登入按鈕,使用者點選後即可觸發登入對話方塊。

多帳戶登入

同時登入多個帳戶的瀏覽器可能會中斷外掛程式的使用者流程。使用者可在目前瀏覽器中登出所有 Google 帳戶,在 Chrome 無痕模式下開啟 Classroom,然後再使用正確的帳戶登入並重試作業。

如果因為多帳戶登入問題,導致不正確的使用者登入外掛程式,則您對 Classroom 外掛程式 API 的呼叫可能會失敗並顯示 InvalidAddOnToken 錯誤。若收到這類錯誤,您應該指示使用者在瀏覽器中登出所有其他帳戶,或是改為以無痕模式在 Chrome 視窗中開啟 Classroom。