Skip to content

Google：OAuth2 通用

本文档包含有关创建用于自定义操作的通用 OAuth2 Google 凭据的说明。

n8n Cloud 用户须知

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

先决条件

设置 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 - Library 。确保您位于正确的项目中。
    检查 Google Cloud 顶部导航栏中的项目下拉菜单。
  2. 转到API 和服务 > 库。
  3. 搜索并选择要启用的 API。例如，对于 Gmail 节点，搜索并启用 Gmail API。
    • Google 视角：
    • 。Google
    • 广告：获取
    • 。Google
    • 文档
    • Google 表格
    • Google 幻灯片

  5. 选择启用。

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

  1. 访问您的Google Cloud Console - Library 。确保您位于正确的项目中。
    检查 Google Cloud 顶部导航栏中的项目下拉菜单。
  2. 打开左侧导航菜单，然后转到API 和服务 > OAuth 同意屏幕。
  3. 选择“开始”以开始配置 OAuth 同意。
  4. 输入应用程序名称和用户支持电子邮件以包含在 Oauth 屏幕上。
  5. 对于“受众” ，请选择“内部”以允许用户访问您组织的 Google 工作区，或选择“外部”以允许任何拥有 Google 帐户的用户访问。有关用户类型的更多信息，请参阅 Google 的用户类型文档。
  6. 选择Google 用来联系您有关项目变更的电子邮件地址。
  7. 阅读并接受 Google 的用户数据政策，然后选择创建。
  8. 在左侧菜单中，选择“品牌” 。
  9. 在授权域部分中，选择添加域：
    • 如果您使用的是 n8n 的云服务，请添加
    • 如果您是
    • ，请添加您的 n8n 实例的域。
  10. 选择页面底部的“保存” 。

创建您的 Google OAuth 客户端凭据

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

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

完成你的 n8n 认证

在 Google 项目和凭证完全配置后，完成 n8n 凭证：

  1. 从 Google 的OAuth 客户端创建模式中，复制客户端 ID 。将其输入到您的 n8n 凭证中。
  2. 从同一个 Google 模态框中，复制客户端密钥。将其输入到您的 n8n 凭证中。
  3. 您必须提供此凭据的范围。有关更多信息，请参阅范围。请以空格分隔的列表形式输入多个范围，例如：
  4. 在 n8n 中，选择使用 Google 登录以完成您的 Google 身份验证。
  5. 保存您的新凭证。

视频

以下视频演示了上述步骤：

作用域

Google 服务具有一个或多个可能的访问范围。范围限制了用户可以执行的操作。请参阅Google API 的 OAuth 2.0 范围，查看所有服务的范围列表。

n8n 并非支持所有范围。创建通用 Google OAuth2 API 凭据时，您可以从下方“支持的范围”列表中输入范围。如果您输入了 n8n 尚不支持的范围，则无法使用。

Supported scopes
服务 可用范围
Gmail
  • https://www.googleapis.com/auth/gmail.labels
  • https://www.googleapis.com/auth/gmail.addons.current.action.compose
  • https://www.googleapis.com/auth/gmail.addons.current.message.action
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.compose
谷歌广告
  • https://www.googleapis.com/auth/adwords
谷歌分析
  • https://www.googleapis.com/auth/analytics
  • https://www.googleapis.com/auth/analytics.readonly
谷歌BigQuery
  • https://www.googleapis.com/auth/bigquery
谷歌图书
  • https://www.googleapis.com/auth/books
Google 日历
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.events
谷歌云自然语言
  • https://www.googleapis.com/auth/cloud-language
  • https://www.googleapis.com/auth/cloud-platform
Google 云端存储
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only
  • https://www.googleapis.com/auth/devstorage.full_control
  • https://www.googleapis.com/auth/devstorage.read_only
  • https://www.googleapis.com/auth/devstorage.read_write
Google 通讯录
  • https://www.googleapis.com/auth/contacts
Google 文档
  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
Google 云端硬盘
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.photos.readonly
Google Firebase云 Firestore
  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/firebase
Google Firebase实时数据库
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/firebase.database
  • https://www.googleapis.com/auth/firebase
谷歌视角
  • https://www.googleapis.com/auth/userinfo.email
Google 表格
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
谷歌幻灯片
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations
Google 任务
  • https://www.googleapis.com/auth/tasks
谷歌翻译
  • https://www.googleapis.com/auth/cloud-translation
GSuite管理员
  • https://www.googleapis.com/auth/admin.directory.group
  • https://www.googleapis.com/auth/admin.directory.user
  • https://www.googleapis.com/auth/admin.directory.domain.readonly
  • https://www.googleapis.com/auth/admin.directory.userschema.readonly

故障排除

Google 尚未验证此应用

如果使用 OAuth 身份验证方法，您可能会看到警告“Google 尚未验证此应用” 。为避免这种情况，您可以从要验证的同一帐户创建 OAuth 凭据。

如果您需要使用由其他帐户（由开发人员或其他第三方）生成的凭据，请按照Google Cloud 文档中的说明进行操作 | 授权错误：Google 尚未验证此应用。

Google Cloud 应用未经授权

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