谷歌服务帐户
使用服务账户比 OAuth2 更复杂。开始之前:
先决条件
- 创建一个 Google Cloud{:targe=_blank .external-link} 账户。
设置服务帐户
将您的 n8n 凭据连接到 Google 服务账户需要四个步骤:
创建 Google Cloud Console 项目
首先,创建一个 Google Cloud Console 项目。如果您已经有项目,请跳转到下一节:
- Google 日历
- Google 日历触发器
- Google 聊天
- Google 联系人
- Google 文档
- Google 云端硬盘
- Google 云端硬盘触发器
- Gmail
- Gmail 触发器
- Google 表格
- Google 表格触发器
- Google 幻灯片
- Google 任务
- YouTube
启用 API
创建项目后,启用您需要访问的 API:
- 访问您的Google Cloud Console - 库。确保您处于正确的项目中。
检查 Google Cloud 顶部导航中的项目下拉列表 - 转到APIs & Services > Library API 和服务 > 库。
- 搜索并选择您要启用的 API。例如,对于 Gmail 节点,搜索并启用 Gmail API。
-
某些集成需要其他 API 或要求您请求访问权限:
- Google 视角:请求 API 访问权限。
- Google Ads:获取开发者令牌。
需要 Google Drive API
以下集成需要 Google Drive API 以及他们自己的 API:
- Google文档
- Google 表格
- Google 幻灯片
Google Vertex AI API
除了 Vertex AI API 之外,您还需要启用 Cloud 资源管理器 API。
-
选择 ENABLE。
设置 Google 云服务帐户
-
访问您的Google Cloud Console - 库。确保您处于正确的项目中。
2. 打开左侧导航菜单并转到 APIs & Services > Credentials API 和服务 > 凭证。 Google 将您带到 Credentials 凭证 页面。 3. 选择+ Create credentials > Service account + 创建凭据 > 服务帐户。 4. 在 Service account name 服务帐户名称 中输入名称,在 Service account ID 服务帐户 ID 中输入 ID。有关详细信息,请参阅创建服务帐户。 5. 选择 Create and continue 创建并继续。 6. 根据您的用例,您可能需要 Select a role 选择角色 和 Grant users access to this service account 授予用户对此服务帐户的访问权限 使用相应的部分。 7. 选择 Done 完成。 8. 在 Service Accounts 服务账户 部分下选择您新创建的服务帐户。打开 Keys 按键 选项卡。 9. 选择 Add key > Create new key 添加密钥 > 创建新密钥。 10. 在出现的模式中,选择 JSON,然后选择 CREATE。 Google 会将文件保存到您的计算机上。.png)
检查 Google Cloud 顶部导航中的项目下拉列表
完成您的 n8n 凭证
在 Google 项目和凭据完全配置后,完成您的 n8n 凭据:
- 打开下载的 JSON 文件。
- 复制
client_email并将其作为 Service Account Email 服务帐户电子邮件 输入到您的 n8n 凭证中。 -
复制
private_key。请勿包含周围的"标记。在您的 n8n 凭证中输入 Private Key 私钥。4. Optional 可选:选择是否要Impersonate a User 冒充用户(打开)。 1. 要使用此选项,您必须以 Google Workspace 超级用户身份为服务帐号启用全网域委派。 2. 输入您要模拟的用户的 Email 电子邮件。 5. 如果您打算将此凭证与 HTTP 请求 节点一起使用,请启用 Set up for use in HTTP Request node 设置用于 HTTP 请求节点。 1. 启用此设置后,您需要为节点添加 Scope(s) 范围。 n8n 预填充了一些范围。有关详细信息,请参阅 Google API 的 OAuth 2.0 范围。 6. Save 保存 您的凭据。较旧版本的 n8n
如果您运行的 n8n 版本早于 0.156.0,请替换 JSON 中的
\n的所有实例包含新行的文件。
视频
https://www.youtube.com/embed/FzQzGODb5Gk?si=YR9vDaTet8vsj-y2
故障排除
服务帐户无法访问 Google 云端硬盘文件
危险
No access to my drive 无法访问我的驱动器
Google 不再允许 2025 年 4 月 15 日之后创建的服务帐号访问 my drive。服务帐户现在只能访问共享驱动器。
虽然不推荐,但如果您需要使用服务帐户访问 my drive,您可以通过启用域范围委托 来实现。您可以在社区中的这篇文章 中了解更多信息。
服务账户无法访问未与其关联用户邮箱共享的 Google Drive 文件和文件夹。
- 访问您的 Google Cloud Console 并复制您的服务账户邮箱。
- 访问您的 Google Drive 并转到指定的文件或文件夹。
- 右键点击文件或文件夹并选择 Share 共享。
- 将您的服务账户邮箱粘贴到 Add People and groups 添加人员和群组 中。
- 选择 Editor 编辑者 以获取读写访问权限,或选择 Viewer 查看者 以获取只读访问权限。
启用域范围委派
要使用服务账户模拟用户,您必须为服务账户启用域范围委派。
警告
Not recommended 不推荐
Google 建议您避免使用域范围委派,因为它允许冒充任何用户(包括超级管理员)并可能带来安全风险。
要向服务账户委派域范围权限,您必须是 Google Workspace 域的超级管理员。然后:
- 在您的 Google Workspace 网域的管理控制台 中,选择汉堡菜单,然后选择 Security > Access and data control > API Controls 安全 > 访问和数据控制 > API 控制。
- 在 Domain wide delegation 域范围内的委派 窗格中,选择 Manage Domain Wide Delegation 管理域范围的委派。
- 选择Add new 添加新的。
- 在 Client ID 客户ID 字段中,输入服务帐户的 Client ID 客户ID。要获取客户端 ID: * 打开您的 Google Cloud Console 项目,然后打开 服务帐户 页面。 * 复制 OAuth 2 Client ID OAuth 2 客户端 ID 并将其用作 Domain Wide Delegation 域范围委派 的 Client ID 客户ID。
- 在 OAuth scopes OAuth 范围 字段中,输入逗号分隔范围的列表以授予您的应用程序访问权限。例如,如果您的应用程序需要在域范围内完全访问 Google Drive API 和 Google Calendar API,请输入:
https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/calendar。 - 选择 Authorize 授权。
在您可以模拟 Workspace 中的所有用户之前,可能需要 5 分钟到 24 小时的时间。