Google：OAuth2 单服务#

本文档包含为单个服务创建 Google 凭据的说明。也可通过视频查看。

n8n Cloud 用户须知

对于以下节点，您可以在 OAuth 部分选择 使用 Google 登录 进行身份验证：

• Google Calendar
• Google Contacts
• Google Drive
• Google Mail
• Google Sheets
• Google Sheets Trigger
• Google Tasks

先决条件#

• 创建 Google Cloud 账户。

设置 OAuth#

将 n8n 凭据连接到 Google 服务需要五个步骤：

1. 创建 Google Cloud Console 项目。
2. 启用 API。
3. 配置 OAuth 同意屏幕。
4. 创建 Google OAuth 客户端凭据。
5. 完成 n8n 凭据设置。

创建 Google Cloud Console 项目#

首先，创建一个 Google Cloud Console 项目。如果已有项目，请跳至下一节：

1. 使用您的 Google 凭据登录 Google Cloud Console。

2. 在顶部菜单中，选择顶部导航栏中的项目下拉菜单，然后选择 新建项目 或直接转到新建项目页面。

3. 输入 项目名称 并选择项目的 位置。

4. 选择 创建。

5. 检查顶部导航栏，确保项目下拉菜单中已选中您的项目。如果没有，请选择您刚刚创建的项目。

   

   检查 Google Cloud 顶部导航栏中的项目下拉菜单

启用 API#

项目创建后，启用您需要访问的 API：

1. 访问您的 Google Cloud Console - 库。确保您处于正确的项目中。

   检查 Google Cloud 顶部导航栏中的项目下拉菜单

2. 转到 API 和服务 > 库。

3. 搜索并选择要启用的 API。例如，对于 Gmail 节点，搜索并启用 Gmail API。

4. 某些集成需要其他 API 或要求您请求访问权限：

   • Google Perspective：请求 API 访问权限。
   • Google Ads：获取 开发者令牌。

   需要 Google Drive API

   以下集成除了需要其自身的 API 外，还需要 Google Drive API：

   • Google Docs
   • Google Sheets
   • Google Slides

   Google Vertex AI API

   除了 Vertex AI API，您还需要启用 Cloud Resource Manager API。

5. 选择 启用。

配置 OAuth 同意屏幕#

如果您尚未在 Google Cloud 项目中使用过 OAuth，则需要配置 OAuth 同意屏幕：

1. 访问您的 Google Cloud Console - 库。确保您处于正确的项目中。

   检查 Google Cloud 顶部导航栏中的项目下拉菜单

2. 打开左侧导航菜单，转到 API 和服务 > OAuth 同意屏幕。Google 会将您重定向到 Google Auth Platform 概览页面。

3. 在 概览 选项卡上选择 开始配置 以开始配置 OAuth 同意屏幕。

4. 输入将在 OAuth 屏幕上显示的 应用名称 和 用户支持电子邮件。选择 下一步 继续。

5. 对于 受众群体，选择 内部 用于组织内 Google Workspace 的用户访问，或选择 外部 用于任何拥有 Google 账户的用户。有关用户类型的更多信息，请参阅 Google 的用户类型文档。选择 下一步 继续。

6. 选择 Google 应使用的 电子邮件地址 以联系您有关项目的变更。选择 下一步 继续。

7. 阅读并接受 Google 的用户数据政策。选择 继续，然后选择 创建。

8. 在左侧菜单中，选择 品牌化。

9. 在 授权域名 部分，选择 添加域名：

   • 如果您使用 n8n 的云服务，请添加 n8n.cloud
   • 如果您是自托管，请添加您的 n8n 实例的域名。

10. 选择页面底部的 保存。

创建 Google OAuth 客户端凭据#

接下来，在 Google 中创建 OAuth 客户端凭据：

1. 访问您的 Google Cloud Console。确保您处于正确的项目中。
2. 在 API 和服务 部分，选择 凭据。
3. 选择 + 创建凭据 > OAuth 客户端 ID。
4. 在 应用类型 下拉菜单中，选择 Web 应用程序。
5. Google 会自动生成一个 名称。将 名称 更新为您在控制台中能识别的名称。
6. 从您的 n8n 凭据中复制 OAuth 重定向 URL。将其粘贴到 Google Console 的 授权重定向 URI 中。
7. 选择 创建。

完成 n8n 凭据#

Google 项目和凭据完全配置后，完成 n8n 凭据设置：

1. 从 Google 的 OAuth 客户端已创建 模态窗口中，复制 客户端 ID。将其输入到您的 n8n 凭据中。
2. 从同一个 Google 模态窗口中，复制 客户端密钥。将其输入到您的 n8n 凭据中。
3. 在 n8n 中，选择 使用 Google 登录 以完成 Google 身份验证。
4. 保存 您的新凭据。

视频#

故障排除#

Google 尚未验证此应用#

如果使用 OAuth 身份验证方法，您可能会看到警告 Google 尚未验证此应用。为避免此情况：

• 如果您的应用 用户类型 是 内部，请使用您要验证的同一账户创建 OAuth 凭据。
• 如果您的应用 用户类型 是 外部，您可以将您的电子邮件添加到应用的测试者列表中：转到 受众群体 页面，并将您登录时使用的电子邮件添加到 测试用户 列表中。

如果您需要使用其他账户（由开发者或其他第三方）生成的凭据，请遵循 Google Cloud 文档 | 授权错误：Google 尚未验证此应用 中的说明。

Google Cloud 应用变为未授权状态#

对于 发布状态 设置为 测试中 且 用户类型 设置为 外部 的 Google Cloud 应用，同意和令牌会在七天后过期。更多信息请参阅 Google Cloud Platform Console 帮助 | 设置 OAuth 同意屏幕。要解决此问题，请在 n8n 凭据模态窗口中重新连接应用。

回到顶部