如何将作用域 API 与 (GSI) Google 身份服务一起使用

Question

Google 最近给我发了一封电子邮件，内容如下：

您的一个或多个网络应用程序使用旧版 Google Sign-In JavaScript 库。请在 2023 年 3 月 31 日之前将您的项目迁移到新的 Google 身份服务 SDK

有问题的项目使用 Google Drive API 以及现在的旧身份验证客户端。

迁移页面 (https://developers.google.com/identity/gsi/web/guides/migration) 上的表格显示：

Old	New	Notes
JavaScript libraries
apis.google.com/js/platform.js	accounts.google.com/gsi/client	Replace old with new.
apis.google.com/js/api.js	accounts.google.com/gsi/client	Replace old with new.

我目前在前端使用gapi 来执行从apis.google.com/js/api.js 加载的授权。根据表格，我需要用新库替换它。

我尝试了以下方法来验证和授权，就像我过去对 gapi 所做的那样：

window.google.accounts.id.initialize({
  client_id: GOOGLE_CLIENT_ID,
  callback: console.log,
  scope: "https://www.googleapis.com/auth/drive.file",
  discoveryDocs: ["https://www.googleapis.com/discovery/v1/apis/drive/v3/rest"],
});

window.google.accounts.id.renderButton(ref.current, {
  size: "medium",
  type: "standard",
});

但是，当我尝试使用 Google 登录按钮进行身份验证时，scope 字段不受尊重，并且它不会要求用户授权请求的范围。它也不会在回调的凭据响应中返回任何形式的访问令牌。

我不确定如何授权使用新库。

Answer 1

在新的谷歌身份服务中，认证时刻和授权时刻是分开的。这意味着，GIS 为网站提供了不同的 API 来调用这两个不同的时刻。您不能再将它们组合在一个 API 调用（和 UX 流）中。

在验证时刻，用户只需登录或注册到您的网站（通过利用 Google 共享的信息）。用户需要做出的唯一决定是他们是否要登录（或注册）。此时无需做出与授权相关的决定。

在身份验证时刻，用户将在所有网站上看到一致的 One Tap 或按钮 UX（因为隐式请求相同的范围）。 一致性会带来更流畅的用户体验，这可能会进一步导致更多的使用。借助一致且优化的身份验证 UX（跨所有网站），用户将获得更好的联合登录体验。

用户登录后，当您确实想从 Google 数据服务加载一些数据时，您可以调用 GIS 授权 API 来触发 UX 流以允许最终用户授予权限。这就是授权时刻。

目前（2021 年 8 月），仅发布了身份验证 API。如果您的网站只关心身份验证，您现在可以迁移到 GIS。如果您还需要授权API，则需等待进一步通知。