顺畅的登录体验

由于登录体验是用户与您的插件进行的首次互动,因此请务必让用户能够尽可能顺畅地完成该流程。请阅读以下部分,熟悉各种登录 API、与登录相关的查询参数、如何处理弹出式窗口拦截器,以及可在开发过程中使用的测试计划,以确保遵循最佳做法。

SSO 实现详情

Google 的 OAuth 2.0 与许多 OAuth 2.0 堆栈兼容。我们强烈建议实现服务器端授权,因为它是最高的安全选项,并且支持使用 iframe 查询参数

在实现 Google 登录功能时,请参阅 Google Identity 网站中提供的技术指南。请务必遵循 Google 登录品牌推广指南。Sketch、SVG 和 EPS 文件可供下载。

登录测试

在提交插件以供审核之前,使用插件测试计划检查您的插件是否符合必要标准,以及是否能够处理已知的极端情况。这些测试与 Google 课堂插件要求核对清单完全相同,并提供了有关如何检查您的插件是否符合这些要求的分步说明。这些测试与您在发布期间用于测试应用的测试相同。

登录查询参数

Google 课堂提供 login_hint 查询参数来帮助重复登录。如需了解更多信息,请参阅“iframe 查询参数”页面的登录相关参数部分。您可以在开发者演示的处理重复访问演示中找到示例代码。

管理弹出式窗口拦截器

您可以通过登录对话框窗口来登录该插件。此窗口会显示帐号选择器屏幕,并允许用户授予 OAuth 权限。最终用户的弹出式窗口拦截器可能会阻止他们完成登录流程。

帐号选择器屏幕示例

图 1. 帐号选择器屏幕示例。

要解决此问题,请为最终用户提供一个按钮,以供其点击以绕过弹出式窗口拦截器。通过这种交互,可以显示登录对话框,以便最终用户可以继续完成登录流程。确保您提供的按钮遵循登录品牌推广指南

按照开发者演示中的登录演示实现一个 Google 品牌登录按钮,点击该按钮即可触发登录对话框。

多账号登录

如果浏览器同时登录了多个帐号,可能会中断插件用户体验流程。最终用户可以在当前浏览器中退出所有 Google 账号,先在无痕式 Chrome 窗口中打开 Google 课堂,然后再使用正确的账号登录并重试操作。

如果由于多账号登录问题而导致错误的用户登录了插件,则对 Classroom 插件 API 的调用可能会失败,并出现 InvalidAddOnToken 错误。如果您收到此类错误,则应指示用户在浏览器中退出所有其他帐号,或改为在无痕 Chrome 窗口中打开“课堂”。