Google：OAuth2 单项服务#

本文档包含为单项服务创建 Google 凭据的说明。相关内容也可通过视频教程查看。 n8n Cloud 用户注意事项对于以下节点，您可以在 OAuth 部分选择 使用 Google 登录 进行身份验证：

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

配置 OAuth#

将您的 n8n 凭据连接到 Google 服务共有五个步骤：

创建 Google Cloud Console 项目。
启用 API。
配置 OAuth 同意屏幕。
创建 Google OAuth 客户端凭据。
完成您的 n8n 凭据配置。

创建 Google Cloud Console 项目#

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

使用你的 Google 账号登录 Google Cloud Console。
在顶部菜单中，选择顶部导航栏的项目下拉菜单，然后选择 新建项目（New project），或直接访问新建项目页面。
输入 项目名称（Project name） 并为你的项目选择 位置（Location）。
点击 创建（Create）。
检查顶部导航栏，确保项目下拉菜单中已选中你刚创建的项目。如果没有，请手动选择你刚刚创建的项目。 Google Cloud 顶部导航中的项目下拉菜单查看 Google Cloud 顶部导航中的项目下拉菜单

启用 API#

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

访问你的 Google Cloud Console - API 库（Library），并确认你处于正确的项目中。Google Cloud 顶部导航中的项目下拉菜单查看 Google Cloud 顶部导航中的项目下拉菜单
进入 API 和服务（APIs & Services） > 库（Library）。
搜索并选择你要启用的 API。例如，对于 Gmail 节点，请搜索并启用 Gmail API。
某些集成需要额外的 API 或需申请访问权限： _ Google Perspective：申请 API 访问权限 _ Google Ads：获取开发者令牌（Developer Token）必需的 Google Drive API 以下集成除了自身所需的 API 外，还需要启用 Google Drive API： _ Google Docs _ Google Sheets * Google Slides Google Vertex AI API 除了 Vertex AI API 外，你还必须启用 Cloud Resource Manager API。
点击 启用（ENABLE）。

配置你的 OAuth 同意屏幕#

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

访问你的 Google Cloud Console - 库。确保你处于正确的项目中。Google Cloud 顶部导航中的项目下拉菜单检查 Google Cloud 顶部导航栏中的项目下拉菜单
打开左侧导航菜单，进入 APIs & Services > OAuth consent screen（API 和服务 > OAuth 同意屏幕）。Google 将会重定向你到 Google 认证平台的概览页面。
在 Overview（概览）标签页中选择 Get started（开始），以启动 OAuth 同意配置。
输入一个 App name（应用名称）和 User support email（用户支持邮箱），这些信息将显示在 OAuth 授权屏幕上。点击 Next（下一步）继续。
对于 Audience（受众），如果你希望仅限组织内的 Google Workspace 用户访问，请选择 Internal（内部）；如果希望任何拥有 Google 账号的用户都能访问，请选择 External（外部）。更多关于用户类型的信息，请参考 Google 的 User type documentation（用户类型文档）。选择 Next 继续。
选择 Google 可用于就项目变更与你联系的 Email addresses（电子邮件地址）。然后选择 Next 继续。
阅读并接受 Google 的用户数据政策（User Data Policy）。点击 Continue（继续），然后选择 Create（创建）。
在左侧菜单中，选择 Branding（品牌设置）。
在 Authorized domains（已授权域名）部分，选择 Add domain（添加域名）：
- 如果你使用的是 n8n 的云服务，请添加 n8n.cloud
- 如果你是自托管，请添加你的 n8n 实例的域名。
点击页面底部的 Save（保存）。

创建你的 Google OAuth 客户端凭据#

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

访问你的 Google Cloud Console。确保你处于正确的项目中。
在 APIs & Services（API 和服务）部分，选择 Credentials（凭据）。
选择 + Create credentials（创建凭据）> OAuth client ID（OAuth 客户端 ID）。
在 Application type（应用类型）下拉菜单中，选择 Web application（Web 应用程序）。
Google 会自动生成一个 Name（名称）。你可以将其更新为一个你在控制台中容易识别的名称。
从你的 n8n 凭据中复制 OAuth Redirect URL（OAuth 重定向 URL），并将其粘贴到 Google Console 的 Authorized redirect URIs（已授权重定向 URI）字段中。
选择 Create（创建）。

完成你的 n8n 凭据#

在 Google 项目和凭据配置完成后，请完成 n8n 凭据的设置：

在 Google 的 OAuth 客户端已创建 弹窗中，复制 客户端 ID（Client ID），并将其填入你的 n8n 凭据中。
在同一个 Google 弹窗中，复制 客户端密钥（Client Secret），并将其填入你的 n8n 凭据中。
在 n8n 中点击 使用 Google 登录（Sign in with Google），完成 Google 身份验证。
保存你的新凭据。

故障排除#

Google 尚未验证此应用#

如果使用 OAuth 认证方式，你可能会看到警告信息：Google 尚未验证此应用。为避免此问题：

如果你的应用 用户类型（User Type） 设置为 内部（Internal），请使用你要认证的同一账户来创建 OAuth 凭据。
如果你的应用 用户类型（User Type） 设置为 外部（External），你可以将你的邮箱添加到应用的测试用户列表中：前往 受众（Audience） 页面，并将你用于登录的邮箱地址添加到 测试用户（Test users） 列表中。

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

对于 发布状态（Publishing status） 设为 测试（Testing） 且 用户类型（User type） 为 外部（External） 的 Google Cloud 应用，授权许可和令牌将在七天后过期。更多信息请参阅 Google Cloud Platform Console 帮助 | 配置 OAuth 同意屏幕。解决此问题的方法是：在 n8n 的凭据配置弹窗中重新连接该应用。