n8n 是一款功能强大的工作流自动化工具,可以帮助您连接不同的应用程序和服务。当您希望在 n8n 中使用 Google Sheets 时,首先需要进行身份验证。本文将详细介绍如何通过 Google Cloud Platform (GCP) 创建 OAuth 2.0 凭证,以便在 n8n 中安全地连接和操作 Google Sheets。
此外,我们还会额外添加一步——开启 Google Drive API 的权限,这在许多需要读写或管理文件的场景下至关重要。
先决条件
-
一个 n8n 实例。
-
一个 Google 账户。
操作步骤
整个配置过程可以分为以下几个关键步骤:
1. 创建 Google Cloud 项目
首先,您需要一个 Google Cloud 项目来管理您的 API 和凭证。
-
点击页面顶部的项目选择器,然后点击 “新建项目” (NEW PROJECT)。
-
为您的项目命名(例如 “n8n-integrations”),然后点击 “创建” (CREATE)。
2. 启用所需的 API
为了让 n8n 能够访问 Google Sheets 和 Google Drive,您必须在项目中启用相应的 API。
-
在 Google Cloud Console 的左侧导航菜单中,选择 “API 和服务” (APIs & Services) > “已启用的 API 和服务” (Enabled APIs & services)。
-
点击 "+ 启用 API 和服务" (+ ENABLE APIS AND SERVICES)。
-
搜索 “Google Sheets API”,选择它并点击 “启用” (ENABLE)。
-
(关键步骤,切勿遗漏!) 再次点击 "+ 启用 API 和服务",然后搜索 “Google Drive API”,并点击 “启用” (ENABLE)。这是最容易被忽略的一步,但对于许多涉及文件操作的工作流至关重要。忘记启用 Drive API 是导致配置失败的最常见原因之一。 启用此 API 可以确保 n8n 不仅能操作表格数据,还能处理与之相关的 Drive 文件。
3. 配置 OAuth 同意屏幕
同意屏幕是用户授权您的应用访问其数据时看到的界面。
-
在左侧导航菜单中,选择 “API 和服务” > “OAuth 同意屏幕” (OAuth consent screen)。
-
选择 “外部” (External) 用户类型,然后点击 “创建” (CREATE)。
-
填写应用信息:
-
应用名称 (App name): 填写一个您能识别的名称,例如 “n8n Workflow Automation”。
-
用户支持电子邮件 (User support email): 选择您的电子邮件地址。
-
开发者联系信息 (Developer contact information): 再次输入您的电子邮件地址。
-
-
点击 “保存并继续” (SAVE AND CONTINUE)。
-
在 “范围” (Scopes) 页面,直接点击 “保存并继续”。
-
在 “测试用户” (Test users) 页面,点击 "+ 添加用户" (+ ADD USERS),然后输入您将用于登录和授权的 Google 账户邮箱。
-
点击 “保存并继续”,然后返回到信息中心。
4. 创建 Google OAuth 客户端凭证
现在,我们可以创建 n8n 用来连接的实际凭证了。
-
在左侧导航菜单中,选择 “API 和服务” > “凭据” (Credentials)。
-
点击 "+ 创建凭据" (+ CREATE CREDENTIALS),然后选择 “OAuth 客户端 ID” (OAuth client ID)。
-
在 “应用类型” (Application type) 下拉菜单中,选择 “Web 应用” (Web application)。
-
为您的凭证命名,例如 “n8n Credentials”。
-
在 “已获授权的重定向 URI” (Authorized redirect URIs) 部分,点击 "+ 添加 URI" (+ ADD URI)。
-
从您的 n8n 实例中复制 OAuth 回调 URL (OAuth Callback URL) 并粘贴到此处。您可以在 n8n 的凭证创建窗口中找到这个 URL。它通常看起来像这样:
https://<your-n8n-domain>/rest/oauth2/callback。 -
点击 “创建” (CREATE)。
创建成功后,您会看到一个包含 客户端 ID (Client ID) 和 客户端密钥 (Client Secret) 的弹窗。请妥善保管这两个值。
5. 在 n8n 中完成配置
最后一步,将您刚刚获取的凭证信息添加到 n8n 中。
-
返回到您的 n8n 实例,在创建 Google Sheets 凭证的窗口中。
-
将从 Google Cloud 获取的 客户端 ID 和 客户端密钥 粘贴到相应的字段中。
-
点击 “使用 Google 登录” (Sign in with Google)。
-
系统会跳转到 Google 授权页面。选择您之前添加为测试用户的那个 Google 账户进行登录和授权。
-
授权成功后,页面会自动跳转回 n8n,凭证就创建成功了!
现在,您就可以在 n8n 的 Google Sheets 节点中使用这个凭证来读取、写入和更新您的电子表格了。
总结
通过以上步骤,您已经成功配置了 n8n 与 Google Sheets 的连接,并开启了 Google Drive 的权限,为更复杂的文件操作流程打下了基础。这个过程虽然涉及多个步骤,但只要跟着指引操作,就能顺利完成。
📬 关注我获取更多资讯