由于登录体验是用户与您的产品和服务的首次互动 因此,请务必确保他们能够像 请阅读以下各部分,熟悉各种 登录 API、与登录相关的查询参数、如何处理弹出式窗口拦截器、 以及可在开发过程中使用的测试计划,以确保您遵循 最佳做法。
SSO 实现详情
Google 的 OAuth 2.0 与许多 OAuth 兼容 2.0 堆栈。我们强烈建议实现服务器端授权,即 是最高安全选项,且支持使用 iframe 查询 参数。
如果您遇到以下情况,请参阅 Google Identity 网站中提供的技术指导: 实现 Google 登录务必遵循 Google 登录品牌信息 指南。我们提供草图、SVG 和 EPS 文件供您下载。
登录测试
使用插件测试计划,检查您的插件是否符合 在提交您的文件之前,您需要达到要求的标准并且能够处理已知的极端情况。 插件以供审核。这些测试与 Google 课堂插件密切相关 要求核对清单,并逐步说明如何检查 您的插件是否满足这些要求这些是 您的应用在发布期间经过测试。
登录查询参数
Google 课堂提供了login_hint
查询参数
重复登录。请参阅 iframe 的与登录相关的参数部分
查询参数页面。示例代码可在
开发者演示中的处理重复访问演示。
管理弹出式窗口拦截器
登录对话框窗口可帮助您登录该插件。这个 窗口会显示账号选择器屏幕,并允许用户授予 OAuth 权限。最终用户的弹出式窗口拦截器可能会阻止他们完成 登录流程
图 1. 账号选择器屏幕示例。
要解决此问题,请为最终用户提供一个可点击的按钮来绕过 弹出式窗口拦截器此互动会允许系统显示登录对话框 以便最终用户可以继续完成登录流程。确保点击该按钮 遵循登录品牌推广指南。
按照开发者演示中的登录演示实现 可以点击以触发登录对话框的 Google 品牌登录按钮。
多账号登录
同时登录多个账号的浏览器可能会中断 插件的用户流最终用户可以退出所有 Google 账号, 当前浏览器或在无痕式 Chrome 窗口中打开 Google 课堂 然后再用正确的账号登录并重试操作。
如果由于多账号登录问题导致登录了插件的用户有误,
您对 Classroom 插件 API 的调用可能会失败,并显示
InvalidAddOnToken
错误。如果您收到此类错误,
用户在浏览器中退出所有其他账号,或打开
改为在 Chrome 无痕式窗口中打开 Google 课堂。