登录

Google 课堂插件必须使用 Google 单点登录 (SSO) 来识别和验证用户。

如需详细了解单点登录，请参阅 Google Identity 的 OpenID Connect 指南。我们还建议您参阅 Google 关于用户注册和登录的官方文档，了解自动登录和 Google 登录品牌推广指南。

如需了解如何在 Google 课堂插件中实现 Google SSO，请参阅“流畅登录”页面。“流畅登录”指南还提及了测试计划，该计划可用于确保您的插件遵循登录最佳实践。

登录流程

为了减少用户登录的麻烦，Google 课堂会在打开 iframe 时提供 login_hint 查询参数。login_hint 是用户的唯一 Google ID，会在用户首次登录您的插件后提供。此参数提供有关已登录 Google 课堂的用户的上下文。如需详细了解这些查询参数，请参阅我们的“登录参数”指南页面。

如果当前 Google 课堂用户的 login_hint 查询参数与该插件中的任何已登录用户都不匹配，您必须显示 Google 登录对话框。该按钮必须符合 Google 的品牌推广指南。如果用户已登录，系统不应提示其重新登录。

图 1. 用户首次启动您的插件时的登录流程。

重要提示： 只有当该插件没有已登录的用户可与 login_hint 查询参数进行比较时，才应显示登录按钮。如果插件使用 login_hint 的值与已登录的用户匹配，则无需显示登录按钮；在这种情况下，插件应让用户保持登录状态。

要点： 除了管理员安装之外，插件还可以允许个人安装。

单独安装会将插件添加到用户自己的账号。用户单独安装插件时，系统会提示用户同意插件的访问范围。

管理员安装会将该插件添加到网域中的任何一个或所有账号，并且只能由网域管理员执行。管理员可以选择代表网域中的所有用户同意所有访问范围；如果管理员选择这样做，系统不会提示用户同意任何访问范围。

如需了解详情，请参阅安装设置。