​

Google Sheets

当你需要工作流步骤创建电子表格、搜索文件、读取数据或追加和更新单元格值时，使用 Google Sheets。

​

配置

配置此步骤前，请在工作区的 Integrations 中通过 OAuth 连接 Google Sheets。若无可用连接，步骤会显示警告并提供 Integrations 链接，而不是账户选择器。

​

常用操作

清除范围或删除工作表等破坏性操作不会出现在工作流操作选择器中。

​

输出

此步骤将 Google Sheets API 响应存储为步骤输出。响应结构取决于所选操作。

​

用上一步的数据填充新表格

常见做法是先创建电子表格，再把更早步骤（例如 AI Keyword Data Search 或 Extract from File）的大数据集写入其中。

1. 添加 Data Transform 步骤，选择 Objects to Grid。将 Source Value 设为对象数组。对于 Extract from File，使用 {{step_1.output}}。对于 AI Keyword Data Search，使用 {{step_1.output.items}}。除非需要指定列顺序，否则将 Headers 留空。
2. 添加 Google Sheets Create Spreadsheet 步骤并设置标题。
3. 添加 Google Sheets Upsert Rows 步骤：
   • Spreadsheet Id 设为 Create Spreadsheet 步骤返回的 ID，例如 {{step_3.output.spreadsheetId}}。
   • Sheet Name 设为 Sheet1（Create Spreadsheet 会创建此默认工作表）。
   • Headers 设为 {{step_2.output.headers}}（使用 Data Transform 步骤的标识符）。
   • Rows 设为 {{step_2.output.rows}}。

无需计算 A1 范围，也不必逐个单元格输入。在 Headers 和 Rows 字段使用 Insert Variable，或在 Raw JSON 标签页粘贴占位符。 Create Spreadsheet 会添加默认的 Sheet1 工作表。如果需要其他工作表名称，请在 Upsert Rows 之前添加 Add Sheet 步骤。

​

注意事项

• 此步骤依赖工作区中已连接的 Google Sheets 集成。
• 工作流操作选择器显示经过筛选的电子表格操作子集。配置了 Google Sheets 工具的智能体可访问更多安全操作。
• 如果先前的连接失效，请在 Integrations 中重新连接 Google Sheets，然后在 Authentication 中选择新账户。

​

将 Google Sheets 用作智能体工具

你也可以在 智能体编辑器 中添加 Google Sheets 工具。打开智能体，点击 Add tool，选择 Google Sheets。在设置面板中选择智能体应使用的已连接账户。 另请参阅：Integrations、Creating and Editing 和 Testing and Iteration