Google Sheets Sheet Within Document 操作#

使用此操作在 Google Sheets 的 Google 电子表格中创建、更新、清除或删除工作表。有关 Google Sheets 节点本身的更多信息，请参考 Google Sheets。

此节点可用作 AI 工具

此节点可用于增强 AI 代理的功能。以这种方式使用时，许多参数可以自动设置，或使用 AI 指导的信息设置 - 在 AI 工具参数文档中了解更多信息。

Append or Update Row 追加或更新行#

使用此操作更新现有行或在工作表中找不到匹配条目时在数据末尾添加新行。

输入这些参数：

Credential to connect with 连接凭据: 创建或选择现有的 Google Sheets 凭据。
Resource 资源: 选择 Sheet Within Document 文档内的工作表。
Operation 操作: 选择 Append or Update Row 追加或更新行。
Document 文档: 选择包含要追加或更新行的工作表的电子表格。
- 选择 From list 从列表 从下拉列表中选择电子表格标题，By URL 按 URL 输入电子表格的 URL，或 By ID 按 ID 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
Sheet 工作表: 选择要追加或更新行的工作表。
- 选择 From list 从列表 从下拉列表中选择工作表标题，By URL 按 URL 输入工作表的 URL，By ID 按 ID 输入 sheetId，或 By Name 按名称 输入工作表标题。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
Mapping Column Mode 映射列模式:
- Map Each Column Manually 手动映射每列: 为每列输入 Values to Send 要发送的值。
- Map Automatically 自动映射: n8n 自动查找与 Google Sheets 中列匹配的传入数据。在此模式下，确保传入数据字段与 Google Sheets 中的列相同。（如果需要，请在此节点之前使用 Edit Fields 节点来更改它们。）
- Nothing 无: 不映射任何数据。

Options 选项#

单元格格式：使用此选项选择如何格式化单元格中的数据。有关更多信息，请参阅 Google Sheets API | CellFormat。
- 让 Google Sheets 格式化（默认）：n8n 根据 Google Sheets 的默认设置格式化单元格中的文本和数字。
- 让 n8n 格式化：工作表中的新单元格将具有与 n8n 提供的输入数据相同的数据类型。
工作表上的数据位置：当您需要指定工作表上的数据范围时使用此选项。
- 标题行：指定包含列标题的行索引。
- 第一个数据行：指定实际数据开始的行索引。
处理输入中的额外字段：当使用映射列模式 > 自动映射时，使用此选项决定如何处理输入数据中与工作表中任何现有列不匹配的字段。
- 插入到新列中（默认）：为任何额外数据添加新列。
- 忽略它们：忽略与现有列不匹配的额外数据。
- 错误：抛出错误并停止执行。
使用追加：启用此选项以使用 Google API 追加端点添加新数据行。
- 默认情况下，n8n 追加空行或列，然后添加新数据。这种方法可以确保数据对齐，但可能效率较低。使用追加端点可以通过最小化 API 调用次数和简化过程来获得更好的性能。但是，如果现有工作表数据存在不一致的情况，如行和列之间的间隙或中断，n8n 可能会在错误的位置添加新数据，导致对齐问题。
- 当性能是优先考虑的因素且工作表中的数据结构一致且没有间隙时，请使用此选项。

请参考 Method: spreadsheets.values.update | Google Sheets API 文档获取更多信息。

Append Row 追加行#

使用此操作在工作表数据末尾追加新行。

输入这些参数：

Credential to connect with 连接凭据: 创建或选择现有的 Google Sheets 凭据。
Resource 资源: 选择 Sheet Within Document 文档内的工作表。
Operation 操作: 选择 Append Row 追加行。
Document 文档: 选择包含要追加行的工作表的电子表格。
- 选择 From list 从列表 从下拉列表中选择电子表格标题，By URL 按 URL 输入电子表格的 URL，或 By ID 按 ID 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
Sheet 工作表: 选择要追加行的工作表。
- 选择 From list 从列表 从下拉列表中选择工作表标题，By URL 按 URL 输入工作表的 URL，By ID 按 ID 输入 sheetId，或 By Name 按名称 输入工作表标题。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
Mapping Column Mode 映射列模式:
- Map Each Column Manually 手动映射每列: 在查找要更新的行时选择 Column to Match On 要匹配的列。为每列输入 Values to Send 要发送的值。
- Map Automatically 自动映射: n8n 自动查找与 Google Sheets 中列匹配的传入数据。在此模式下，确保传入数据字段与 Google Sheets 中的列相同。（如果需要，请在此节点之前使用 Edit Fields 节点来更改它们。）
- Nothing 无: 不映射任何数据。

Options 选项#

单元格格式：使用此选项选择如何格式化单元格中的数据。有关更多信息，请参阅 Google Sheets API | CellFormat。
- 让 Google Sheets 格式化（默认）：n8n 根据 Google Sheets 的默认设置格式化单元格中的文本和数字。
- 让 n8n 格式化：工作表中的新单元格将具有与 n8n 提供的输入数据相同的数据类型。
工作表上的数据位置：当您需要指定工作表上的数据范围时使用此选项。
- 标题行：指定包含列标题的行索引。
- 第一个数据行：指定实际数据开始的行索引。
处理输入中的额外字段：当使用映射列模式 > 自动映射时，使用此选项决定如何处理输入数据中与工作表中任何现有列不匹配的字段。
- 插入到新列中（默认）：为任何额外数据添加新列。
- 忽略它们：忽略与现有列不匹配的额外数据。
- 错误：抛出错误并停止执行。
使用追加：启用此选项以使用 Google API 追加端点添加新数据行。
- 默认情况下，n8n 追加空行或列，然后添加新数据。这种方法可以确保数据对齐，但可能效率较低。使用追加端点可以通过最小化 API 调用次数和简化过程来获得更好的性能。但是，如果现有工作表数据存在不一致的情况，如行和列之间的间隙或中断，n8n 可能会在错误的位置添加新数据，导致对齐问题。
- 当性能是优先考虑的因素且工作表中的数据结构一致且没有间隙时，请使用此选项。

请参考 Method: spreadsheets.values.append | Google Sheets API 文档获取更多信息。

Clear a sheet 清除工作表#

使用此操作清除工作表中的所有数据。

输入这些参数：

Credential to connect with 连接凭据: 创建或选择现有的 Google Sheets 凭据。
Resource 资源: 选择 Sheet Within Document 文档内的工作表。
Operation 操作: 选择 Clear 清除。
Document 文档: 选择包含要清除数据的工作表的电子表格。
- 选择 From list 从列表 从下拉列表中选择电子表格标题，By URL 按 URL 输入电子表格的 URL，或 By ID 按 ID 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
Sheet 工作表: 选择要清除数据的工作表。
- 选择 From list 从列表 从下拉列表中选择工作表标题，By URL 按 URL 输入工作表的 URL，By ID 按 ID 输入 sheetId，或 By Name 按名称 输入工作表标题。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
Clear 清除: 选择要从工作表中清除的数据。
- Whole Sheet 整个工作表: 清除整个工作表的数据。开启 Keep First Row 保留第一行 以保留工作表的第一行。
- Specific Rows 特定行: 清除数据特定行。还需输入：
  - Start Row Number 起始行号: 输入要清除的第一行号。
  - Number of Rows to Delete 要删除的行数: 输入要清除的行数。1 仅清除 Start Row Number 中的行数据。
- Specific Columns 特定列: 清除数据特定列。还需输入：
  - Start Column 起始列: 使用字母表示法输入要清除的第一列。
  - Number of Columns to Delete 要删除的列数: 输入要清除的列数。1 仅清除 Start Column 中的数据。
- Specific Range 特定范围: 输入要清除数据的表格范围，使用 A1 表示法。

请参考 Method: spreadsheets.values.clear | Google Sheets API 文档获取更多信息。

Create a new sheet 创建新工作表#

使用此操作创建新工作表。

输入这些参数：

Credential to connect with 连接凭据: 创建或选择现有的 Google Sheets 凭据。
Resource 资源: 选择 Sheet Within Document 文档内的工作表。
Operation 操作: 选择 Create 创建。
Document 文档: 选择要在其中创建新工作表的电子表格。
- 选择 From list 从列表 从下拉列表中选择电子表格标题，By URL 按 URL 输入电子表格的 URL，或 By ID 按 ID 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
Title 标题: 输入新工作表的标题。

Options 选项#

Hidden 隐藏: 开启此选项以在 UI 中隐藏工作表。
Right To Left 从右到左: 开启此选项以使用 RTL 工作表而不是 LTR 工作表。
Sheet ID 工作表 ID: 输入工作表的 ID。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
Sheet Index 工作表索引: 默认情况下，新工作表是电子表格中的最后一个工作表。要覆盖此行为，请输入您希望新工作表使用的索引。当您在给定索引处添加工作表时，Google 会增加所有后续工作表的索引。有关更多信息，请参考 Sheets | SheetProperties 文档。
Tab Color 标签颜色: 输入颜色的十六进制代码或使用颜色选择器设置 UI 中标签的颜色。

请参考 Method: spreadsheets.batchUpdate | Google Sheets API 文档获取更多信息。

Delete a sheet 删除工作表#

使用此操作永久删除工作表。

输入这些参数：

Credential to connect with 连接凭据: 创建或选择现有的 Google Sheets 凭据。
Resource 资源: 选择 Sheet Within Document 文档内的工作表。
Operation 操作: 选择 Delete 删除。
Document 文档: 选择包含要删除的工作表的电子表格。
- 选择 From list 从列表 从下拉列表中选择电子表格标题，By URL 按 URL 输入电子表格的 URL，或 By ID 按 ID 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
Sheet 工作表: 选择要删除的工作表。
- 选择 From list 从列表 从下拉列表中选择工作表标题，By URL 按 URL 输入工作表的 URL，By ID 按 ID 输入 sheetId，或 By Name 按名称 输入工作表名称。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。

请参考 Method: spreadsheets.batchUpdate | Google Sheets API 文档获取更多信息。

Delete Rows or Columns 删除行或列#

使用此操作删除工作表中的行或列。

输入这些参数：

Credential to connect with 连接凭据: 创建或选择现有的 Google Sheets 凭据。
Resource 资源: 选择 Sheet Within Document 文档内的工作表。
Operation 操作: 选择 Delete Rows or Columns 删除行或列。
Document 文档: 选择包含要删除行或列的工作表的电子表格。
- 选择 From list 从列表 从下拉列表中选择电子表格标题，By URL 按 URL 输入电子表格的 URL，或 By ID 按 ID 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
Sheet 工作表: 选择要删除行或列的工作表。
- 选择 From list 从列表 从下拉列表中选择工作表标题，By URL 按 URL 输入工作表的 URL，By ID 按 ID 输入 sheetId，或 By Name 按名称 输入工作表名称。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
Start Row Number 起始行号 或 Start Column 起始列: 输入开始删除的行号或列字母。
Number of Rows to Delete 要删除的行数 或 Number of Columns to delete 要删除的列数: 输入要删除的行数或列数。

请参考 Method: spreadsheets.batchUpdate | Google Sheets API 文档获取更多信息。

Get Row(s) 获取行#

使用此操作从工作表读取一行或多行。

输入这些参数：

Credential to connect with 连接凭据: 创建或选择现有的 Google Sheets 凭据。
Resource 资源: 选择 Sheet Within Document 文档内的工作表。
Operation 操作: 选择 Get Row(s) 获取行。
Document 文档: 选择包含要获取行的工作表的电子表格。
- 选择 From list 从列表 从下拉列表中选择电子表格标题，By URL 按 URL 输入电子表格的 URL，或 By ID 按 ID 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
Sheet 工作表: 选择要读取行的工作表。
- 选择 From list 从列表 从下拉列表中选择工作表标题，By URL 按 URL 输入工作表的 URL，By ID 按 ID 输入 sheetId，或 By Name 按名称 输入工作表名称。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
Filters 过滤器: 默认情况下，节点返回工作表中的所有行。设置过滤器以返回有限的结果集：
- Column 列: 选择工作表中要搜索的列。
- Value 值: 输入要搜索的单元格值。您可以在此处拖拽输入数据参数。如果您的过滤器匹配多行，n8n 返回第一个结果。如果您想要所有匹配的行：
  1. 在 Options 选项 下，选择 Add Option 添加选项 > When Filter Has Multiple Matches 当过滤器有多个匹配时。
  2. 将 When Filter Has Multiple Matches 更改为 Return All Matches 返回所有匹配。

Options 选项#

Data Location on Sheet 工作表上的数据位置: 使用此选项指定数据范围。默认情况下，n8n 将自动检测范围直到工作表中的最后一行。
Output Formatting 输出格式: 使用此选项选择 n8n 如何格式化 Google Sheets 返回的数据。
General Formatting 常规格式:
- Values (unformatted) 值（未格式化）（默认）: n8n 移除货币符号和其他特殊格式。数据类型保持为数字。
- Values (formatted) 值（已格式化）: n8n 显示值在 Google Sheets 中显示的方式（例如，保留逗号或货币符号），通过将数据类型从数字转换为字符串。
- Formulas 公式: n8n 返回公式。它不计算公式输出。例如，如果单元格 B2 有公式 =A2，n8n 将 B2 的值返回为 =A2（文本形式）。有关更多信息，请参考 About date & time values | Google Sheets。
Date Formatting 日期格式: 有关更多信息，请参考 DateTimeRenderOption | Google Sheets。 - Formatted Text 格式化文本（默认）: 如在 Google Sheets 中显示，这取决于电子表格区域设置。例如 01/01/2024。 - Serial Number 序列号: 自 1899 年 12 月 30 日以来的天数。
When Filter Has Multiple Matches 当过滤器有多个匹配时: 设置为 Return All Matches 返回所有匹配 以获取多个匹配。默认情况下仅返回第一个结果。

第一行

n8n 将 Google Sheet 中的第一行视为标题行，在读取所有行时不返回它。如果您想读取第一行，请使用 Options 设置 Data Location on Sheet。

请参考 Method: spreadsheets.batchUpdate | Google Sheets API 文档获取更多信息。

Update Row 更新行#

使用此操作更新工作表中的现有行。此操作仅更新现有行。要在工作表中找不到匹配条目时追加行，请改用 Append or Update Row 操作。

输入这些参数：

Credential to connect with 连接凭据: 创建或选择现有的 Google Sheets 凭据。
Resource 资源: 选择 Sheet Within Document 文档内的工作表。
Operation 操作: 选择 Update Row 更新行。
Document 文档: 选择包含要更新的工作表的电子表格。
- 选择 From list 从列表 从下拉列表中选择电子表格标题，By URL 按 URL 输入电子表格的 URL，或 By ID 按 ID 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
Sheet 工作表: 选择要更新的工作表。
- 选择 From list 从列表 从下拉列表中选择工作表标题，By URL 按 URL 输入工作表的 URL，By ID 按 ID 输入 sheetId，或 By Name 按名称 输入工作表标题。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
Mapping Column Mode 映射列模式:
- Map Each Column Manually 手动映射每列: 为每列输入 Values to Send 要发送的值。
- Map Automatically 自动映射: n8n 自动查找与 Google Sheets 中列匹配的传入数据。在此模式下，确保传入数据字段与 Google Sheets 中的列相同。（如果需要，请在此节点之前使用 Edit Fields 节点来更改它们。）
- Nothing 无: 不映射任何数据。

Options 选项#

Cell Format 单元格格式: 使用此选项选择如何格式化单元格中的数据。有关更多信息，请参考 Google Sheets API | CellFormat。
- Let Google Sheets format 让 Google Sheets 格式化（默认）: n8n 根据 Google Sheets 的默认设置格式化单元格中的文本和数字。
- Let n8n format 让 n8n 格式化: 工作表中的新单元格将具有与 n8n 提供的输入数据相同的数据类型。
Data Location on Sheet 工作表上的数据位置: 当您需要指定工作表上的数据范围时使用此选项。
- Header Row 标题行: 指定包含列标题的行索引。
- First Data Row 首个数据行: 指定实际数据开始的行索引。

请参考 Method: spreadsheets.batchUpdate | Google Sheets API 文档获取更多信息。