登入體驗是使用者與外掛程式進行的初次互動,因此,他們必須能夠盡可能順利完成流程。請詳閱下列各節,熟悉各種登入 API、登入相關查詢參數、如何處理彈出式視窗封鎖程式,以及您可以在開發期間使用的測試計畫,確保您遵循最佳做法。
單一登入 (SSO) 實作詳細資料
Google 的 OAuth 2.0 與許多 OAuth 2.0 堆疊相容。我們強烈建議您實作伺服器端授權,因為這是安全性最高的選項,且支援使用 iframe 查詢參數。
實作 Google 登入功能時,請參閱 Google 身分識別服務網站提供的技術指南。請務必遵循 Google 登入品牌宣傳指南。提供 Sketch、SVG 和 EPS 檔案供下載。
登入測試
在將外掛程式送交審查前,請使用外掛程式測試計畫,確認外掛程式符合必要標準,且能夠處理已知的極端案例。這些測試與 Classroom 外掛程式的需求檢查清單十分相似,並提供逐步操作說明,協助您檢查外掛程式是否符合這些需求。這些測試與應用程式在發布期間接受的測試相同。
登入查詢參數
Google Classroom 提供 login_hint
查詢參數,方便使用者重複登入。如需更多資訊,請參閱 iframe 查詢參數頁面的登入相關參數部分。您可以在開發人員逐步操作說明的「處理重複造訪」中找到程式碼範例。
管理彈出式視窗封鎖程式
登入對話方塊可讓使用者輕鬆登入外掛程式。這個視窗會顯示帳戶選擇器畫面,讓使用者授予 OAuth 權限。使用者的彈出式視窗攔截器可能會阻止他們完成登入流程。
圖 1. 帳戶選取畫面範例。
如要解決這個問題,請為使用者提供按鈕,讓他們按一下即可略過彈出式視窗封鎖程式。這項互動可讓系統顯示登入對話方塊,方便使用者繼續登入流程。請務必提供符合登入品牌規範的按鈕。
請按照開發人員操作說明中的登入操作說明,導入 Google 品牌登入按鈕,讓使用者按下按鈕時觸發登入對話方塊。
多重登入
如果瀏覽器同時登入多個帳戶,可能會中斷外掛程式的使用者流程。使用者可以先在目前的瀏覽器中登出所有 Google 帳戶,或在 Chrome 無痕式視窗中開啟 Classroom,再使用正確的帳戶登入並重試操作。
如果由於多重登入問題,導致錯誤的使用者登入加購項目,您對 Classroom 加購項目 API 的呼叫可能會失敗,並傳回 InvalidAddOnToken
錯誤。如果您收到這類錯誤,請指示使用者在瀏覽器中登出所有其他帳戶,或改為在 Chrome 無痕模式視窗中開啟 Classroom。