第 11 章 连接到 Google 应用程序
集成可以连接到这些 Google 应用程序:Gmail、Calendar、Sheets。详情请查看以下主题:
11.1. 将 Fuse Online 注册为 Google 客户端应用程序 复制链接链接已复制到粘贴板!
在集成中,要连接到 Gmail、Google Calendar 或 Google Sheets,您必须将 Fuse 在线环境注册为 Google 客户端应用程序。在注册过程中,您可以启用 Google API 并创建 Fuse Online 用于访问您启用的 Google API 的凭证。
注册后,您可以创建多个到 Gmail、Google Calendar 和 Google Sheets 的连接。您可以在多个集成中使用每个连接。虽然 Google 应用程序的每个连接都可能会使用相同的 Google 客户端 ID 和 Google 客户端 secret(在注册过程中获得),但每个连接都可以访问您选择的不同的 Google 帐户。
此流程指导您启用 Gmail API、Google Calendar API 和 Google Sheets API。但是,您只能启用您需要的 API,而不是所有三个 API。以后,如果您需要创建没有启用 API 的应用程序的连接,可以在此处返回并按照说明启用其 API。
您必须为 Fuse Online 创建新的 Google 客户端应用程序。Google 为新客户端应用程序提供的凭证包含一个刷新令牌,用于刷新访问令牌。此刷新令牌仅可第一次使用 Fuse Online 客户端应用使用凭据。在 Fuse Online 中,与 Gmail、Google Calendar 和 Google Sheets 的连接都可以使用相同的 Google 客户端 ID 和 Google 客户端 secret。如果这样做,刷新令牌适用于所有连接到 Google 应用程序。当您在 Fuse Online 用户界面中查看连接详情时,不要单击 Validate 按钮。验证是凭证的第二个使用,刷新令牌不再是客户端凭证的一部分。但是,您可以重新连接到 Google 应用程序。
在开发环境中,如果您选择使用 Google 客户端 ID 和 Google 客户端 secret,请小心使用,而不是使用在线 OAuth 客户端。Fuse Online 需要在第一次 OAuth 交换上请求的离线访问。如果另一个 OAuth 客户端已经进入 OAuth Exchange,且没有请求离线访问,则 Fuse Online 无法在后续的 OAuth 交换时获得离线访问权限。如果您不确定是否在第一个交换上请求离线访问,请为 Fuse Online 创建一个新的 Google 客户端应用程序。
先决条件
- 您必须能够登录到您要将 Fuse Online 注册为 Google 客户端应用程序的 Google 帐户。
流程
在 Fuse Online 中:
- 在左侧导航面板中,点 Settings。
-
在 Settings 页面中,在回调 URL 右侧,点
将 Fuse Online 环境的回调 URL 复制到剪贴板。稍后您将需要这个 URL。
在另一个浏览器标签页中,进入
https://console.developers.google.com并执行以下操作:检查您是否已注册到 Google 帐户,该帐户将使用 将 Fuse Online 注册为 Google 客户端应用程序。或者,选择其他 Google 帐户并登录到该帐户。
当前 Google 项目的名称将显示在 Google API 页面的顶部。
- 要使用当前项目为 Fuse Online 授予授权,请继续下一步。要在另一个 Google 项目中向 Fuse Online 授予授权,请选择或创建该项目。如果此 Google 帐户还没有项目,您必须创建一个。
对于每个要启用的 Google API(Calendar、Gmail 或 Sheets):
-
在左上角,点
,然后选择 API 和 Services > Library。
- 如有必要,向下滚动以查看卡的 Google Workspace 行。
点 Google API 卡(Calendar、Gmail 或 Sheets)。
Google API 的摘要页面将打开。
- 单击 启用。Google 启用 API 并打开 API 概述页面。
- 向下滚动并单击 Gmail API 卡,它会显示页面,其中指出启用了 Gmail API。
-
在左上角,点
为您的客户端应用程序指定一个名称:
在 API 概述页面中,在左侧导航面板中,单击 Credentials,然后单击 Configure Consent Screen。
此时会出现 OAuth 批准屏幕。
在 Application Name 字段中,选择 External。
注: 如果您是一个 Google Workspace 用户,则可以选择 Internal。
- 点 Create。
-
键入 Fuse Online 客户端应用程序的名称。例如,键入
Fuse Online 客户端应用程序。 - 跳过其他字段。
- 单击 Save,再继续。
- 在 Scopes 和 Test Users 页面中,跳过选项,点 Save 并开始。
获取客户端应用程序凭证,如下所示:
- 在 Create Credentials 右侧,单击下箭头以显示菜单,然后选择 OAuth 客户端 ID。
- 在出现的页面中,在 应用程序类型 中选择 Web 应用程序。
-
在 Name 字段中,为您的 Fuse 在线环境输入 OAuth 客户端 ID 的名称。这与您为客户端应用程序本身输入的名称不同。例如,
为 Fuse 在线键入 OAuth 客户端 ID。 - 跳过 授权 JavaScript 源。
- 在 Authorized redirect URIs 字段中,粘贴您在此流程开始时从 Fuse Online 环境中复制的回调 URL。
- 点 Create 显示 Fuse Online 环境的客户端 ID 和客户端 secret。
-
在客户端 ID 字段右侧,点
将客户端 ID 复制到您的剪贴板。
返回到 Fuse Online Settings 页面并执行以下操作:
- 展开 Gmail、Google Calendar 和 Google Sheets 的条目。
- 在每个 Google 应用程序的 Client ID 字段中,粘贴您刚刚复制的 Google 客户端 ID。
-
返回到 Google developers 站点和客户端 secret 字段右侧,点
将客户端 secret 复制到您的剪贴板。
返回到 Fuse Online Settings 页面,并在每个 Google 应用程序的条目中执行以下操作:
- 在 Client Secret 字段中粘贴您刚刚复制的 Google 客户端 secret。
- 点击 Save。您应该会收到 注册成功! 通知。
- 折叠条目。
结果
对于您启用的每个 Google 应用程序 API,您可以创建一个与该应用程序的连接。
从 Fuse Online 到 Google 应用程序的所有连接都使用相同的 Google 客户端 ID 和 Google 客户端 secret。
Google 客户端 ID 和 Google 客户端 secret 包含令牌刷新信息,以确保与 Google 应用程序连接的集成继续正常工作。因此,您不应该 获得新凭证。如果您这样做,则需要重新创建每个 Google 连接,将旧连接替换为新连接,并重新发布使用 Google 连接的每个集成。