“使用 Google 帐号登录”功能

以下是“使用 Google 账号登录”的主要功能。您可以使用代码生成器生成代码，以便将“一键快捷登录”“自动登录”和“使用 Google 账号登录”按钮嵌入到您的网页中。

用户可以在支持 FedCM 的浏览器中全面停用第三方登录功能。当用户选择停用后，一键登录和自动登录将不可用，也不会显示。

一键快捷功能

当用户访问您的网站时，如果浏览器中有有效的 Google 会话，系统可能会提示用户使用其 Google 账号在您的网站上登录或注册。用户只需点按一次（对于单个 Google 会话）或两次（存在多个 Google 会话）即可完成联合登录或注册流程。由于所有用户体验流程都在网页中嵌入的 iframe 中执行，因此一键式体验可实现顺畅的用户入口点。

用户可以选择在全球范围内停用“一键式登录”。在这种情况下，Google 账号不会显示“一键式登录”。如果所有有效的 Google 账号都选择停用此功能，系统将不会显示“一键式登录”界面。

注意 ：由于智能反跟踪 (ITP) 功能，ITP 浏览器（例如 iOS 版 Chrome、Safari 和 Firefox）会显示额外的欢迎页面。开发者可以在一款或多款 ITP 浏览器中停用此功能。如需了解详情，请参阅ITP 浏览器上的一键式支持。

要点 ：如需详细了解一键式体验，请参阅了解一键式用户体验。

建议您在主登录对话框和叶页上都添加一键式登录功能。开发者更青睐“一键式”验证，原因有很多：

• 提高用户转化率。如需详细了解我们的部分合作伙伴如何成功使用“一键式登录”功能来改善注册和登录体验，请参阅我们的案例。
• 允许用户在登录和注册时无需重定向到专用登录和注册页面。
• 让用户能够在您的网站上下文中登录和注册，而无需离开当前的体验历程。
• 在用户再次访问时，通过个性化提示和自动登录功能减少重复账号。

警告： 一键式操作界面应在网页加载或其他窗口事件时自动显示，而不是由用户手势触发。否则，您可能会获得不佳的用户体验。由于用户选择全面停用、冷却或没有 Google 会话，用户在执行用户手势后可能不会看到任何界面。

自动登录

借助“一键式登录”，您还可以启用可取消的自动登录功能，为回访用户提供简化版用户体验。回访用户无需执行任何用户手势即可自动登录您的网站。如果只有一个已获用户同意与您的应用分享其账号个人资料的有效 Google 账号，系统就会触发自动登录。

用户可以在短时间内取消自动登录流程，从而确保用户控制权和透明度。如果用户取消自动登录，Google 账号登录会将该决定记住一天，然后再重新启用自动登录。借助可取消功能，用户可以更好地控制自动登录流程。

启用 FedCM 后，自动登录事件之间会有一个 10 分钟的冷却期。如果在此期间触发了自动登录，用户将遵循一键式登录流程，而不是自动登录流程。

“使用 Google 账号登录”（适用于网页）不支持静默登录，在这种情况下，系统会返回凭据，但不会显示任何界面。当 Google 向依赖方返回登录凭据时，最终用户始终会看到某个界面（手动或自动登录）。这有助于增强用户隐私保护和控制力度。

您需要根据自己网站的用户体验来决定是否启用自动登录功能。

注意：自动登录功能只能在“一键登录”流程中启用，不能在“使用 Google 账号登录”按钮流程中启用。

要点：如需了解详情，请参阅自动登录和自动退出。

“使用 Google 账号登录”按钮

与一键登录不同，“使用 Google 账号登录”按钮流程必须由用户手势触发。为此，“使用 Google 账号登录”仅提供用于呈现按钮的 API，但不提供用于以编程方式启动按钮流程的 API。作为开发者，您只需在网页上呈现“使用 Google 账号登录”按钮即可。何时触发按钮用户体验流程由库透明处理。

换句话说，现在，“使用 Google 账号登录”按钮必须由 Google Identity 服务 JavaScript 库生成。借助按钮渲染 API，您可以自定义颜色、形状、文本和大小，以满足您网站的品牌推广要求，同时仍遵守 Google 的指南。通过在各个网站上使用一致的按钮，用户可以快速识别、信任并使用这些按钮。

注意：“使用 Google 账号登录”不提供用于程序化启动按钮流程的 API。

警告：不支持使用您自己的按钮，因为没有 API 可在用户点击您的按钮时启动按钮流程。

系统还可能会使用用户个人资料信息来呈现该按钮。只有当至少有一个活跃的 Google 会话之前在您的网站上对用户进行了身份验证时，系统才会显示个性化按钮。个性化按钮可提醒最终用户他们之前使用过“使用 Google 账号登录”功能，从而有助于防止在您的网站上不必要地创建重复账号。对于仅偶尔访问您网站的最终用户，这尤其有用。他们可能会忘记自己使用的登录方法。

要点 ：如需详细了解个性化按钮，请参阅了解个性化按钮。

除了个性化按钮之外，“使用 Google 账号登录”按钮还支持通过 Family Link 管理的 Google 账号，并遵守组织管理员设置的 Google Workspace 政策。

“使用 Google 账号登录”按钮流程支持弹出式窗口和重定向用户体验模式。

• 在弹出式窗口用户体验中，点击“使用 Google 账号登录”按钮后，网页上方会打开一个新的弹出式窗口。按钮用户体验流程在弹出式窗口中呈现。
• 在重定向用户体验中，点击“使用 Google 账号登录”按钮后，系统会发生全页重定向。按钮用户体验流程会在同一窗口中呈现。不过，当按钮用户体验显示时，用户将无法再看到您的网页。

撤消用户同意

用户可以撤消其同意共享 ID 令牌的许可。“使用 Google 账号登录”提供了一个 API，可用于以编程方式撤消用户意见征求。

与 Google Identity 服务授权 API 中的 revoke() 方法不同，您无需访问令牌即可撤消用户同意。不过，您需要提供目标 Google 会话的电子邮件地址或 Google 用户 ID，并且浏览器中应有该账号的有效 Google 会话。

撤消 API 会撤消 ID 令牌共享以及之前授予的任何其他授权范围。无论您使用哪个撤消 API，情况始终如此。

要点 ：撤消 API 不会显示任何界面。如需了解详情，请参阅撤消用户同意。

代码生成器

代码生成器是一款开发者工具，可帮助您生成客户端集成代码。借助“使用 Google 账号登录”HTML API，您可能无需任何 JavaScript 代码即可实现客户端集成。

对于选择使用 JavaScript API 的开发者，建议您使用代码生成器以互动方式设计按钮。您也可以先生成 HTML 代码，然后将代码复制到 JavaScript API 中的相应字段。

要点 ：使用代码生成器生成客户端集成代码。