順暢登入

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

單一登入 (SSO) 實作詳細資料

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

實作 Google 登入功能時,請參閱 Google Identity 網站提供的技術指南。請務必遵守 Google 登入品牌宣傳指南。系統會下載 Sketch、SVG 和 EPS 檔案。

登入測試

將外掛程式送交審查之前,請使用外掛程式測試計畫來檢查外掛程式是否符合必要標準,能夠處理已知的邊緣情況。這些測試與 Classroom 外掛程式需求檢查清單相似,並且會提供逐步說明,協助您確認外掛程式是否符合這些需求條件。這些測試與在發布期間測試的應用程式相同。

登入查詢參數

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

管理彈出式視窗攔截器

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

帳戶選取器畫面範例

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

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

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

多帳戶登入

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

如果因多次登入問題而誤登入外掛程式的使用者,呼叫 Classroom 外掛程式 API 可能會失敗,並顯示 InvalidAddOnToken 錯誤。如果收到這類錯誤,請指示使用者在瀏覽器中登出所有其他帳戶,或改為在 Chrome 無痕視窗中開啟 Classroom。