准备表格

连接前需要在 Google Sheets 中完成的准备：创建表格、共享表格、复制表格链接

您不需要创建 Google Cloud 项目、启用 API，也不需要下载 JSON 密钥——服务账号已经在服务端配置好了。您只需要提供表格本身、访问权限以及表格链接。

第 1 步：创建表格

打开 Google Sheets，创建一个新表格——或者使用您已经在用的表格。表格名称可以随意填写，服务不会对其进行检查。

第 2 步：复制服务账号地址

该地址显示在您的账户中——您将把表格共享给这个账号。

  1. 打开API 连接——即用户菜单（账户右上角）中的"API 连接"项。
  2. 找到"Google Sheets"卡片。
  3. 在"服务账号"一行中，点击地址旁边的复制图标——会出现"邮箱已复制"通知。
截图"API 连接"页面上处于"未连接"状态的"Google Sheets"卡片：带地址和复制按钮的"服务账号"行、值为"未连接"的"表格"行，以及卡片标题处的"连接"按钮。

第 3 步：以"编辑者"身份共享表格

  1. 在浏览器中打开您的表格。
  2. 点击右上角的"Share"（在部分版本的 Google 界面中，该项称为"Sharing settings"）。
  3. 粘贴已复制的服务账号地址。
  4. 选择"Editor"角色。
  5. 点击"Send"。
"Viewer"角色是不够的：本服务不仅需要读取表格，还需要向其中写入结果。在获得访问权限之前，表格对服务来说完全不存在——连接测试会返回"未找到表格，或表格未共享给服务账号"。
这五个步骤在您的账户中随时可以查看：服务账号地址旁边的"怎么做？"按钮会在窗口中打开它们。当服务发现访问权限缺失时，也会自动弹出同样的窗口。

第 4 步：复制表格链接

该链接就是浏览器地址栏中已打开表格的地址：

https://docs.google.com/spreadsheets/d/1AbCdEfGhIjKlMnOpQrStUvWxYz/edit

请完整复制——无需从地址中间截取标识符，服务会自行提取。

表格已准备就绪。接下来——连接表格。