Google Sheets 文档内工作表操作#

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

该节点可用作 AI 工具该节点可用于增强 AI 代理的能力。以此方式使用时，许多参数可以自动设置，或由 AI 引导信息进行设置 - 更多详情请参阅 AI 工具参数文档。

追加或更新行#

使用此操作可更新现有行，如果在工作表中未找到匹配条目，则在数据末尾添加新行。

输入以下参数：

连接凭据：创建或选择现有的 Google Sheets 凭据。
资源：选择 文档内工作表 (Sheet Within Document)。
操作：选择 追加或更新行 (Append or Update Row)。
文档：选择包含要追加或更新行的工作表的电子表格。
- 选择 从列表 (From list) 从下拉列表中选择电子表格标题，通过 URL (By URL) 输入电子表格的 URL，或 通过 ID (By ID) 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
工作表：选择要追加或更新行的工作表。
- 选择 从列表 (From list) 从下拉列表中选择工作表标题，通过 URL (By URL) 输入工作表的 URL，通过 ID (By 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)：不映射任何数据。

选项#

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

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

追加行#

使用此操作可在工作表的现有数据末尾追加新行。输入以下参数：

连接凭据：创建或选择现有的 Google Sheets 凭据。
资源：选择 文档内的工作表。
操作：选择 追加行。
文档：选择需要追加行的工作表所属的电子表格。
- 选择 从列表 通过下拉菜单选择电子表格标题，通过 URL 输入电子表格链接，或 通过 ID 输入 spreadsheetId。
- 可在 Google Sheets 链接中获取 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
工作表：选择需要追加行的工作表。
- 选择 从列表 通过下拉菜单选择工作表标题，通过 URL 输入工作表链接，通过 ID 输入 sheetId，或 通过名称 输入工作表标题。
- 可在 Google Sheets 链接中获取 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
列映射模式：
- 手动映射每列：查找要更新的行时选择 匹配列。为每个列输入 要发送的值。
- 自动映射：n8n 会自动匹配传入数据与 Google Sheets 中的列。在此模式下，请确保传入数据字段与 Google Sheets 中的列名保持一致（如有需要，可在此节点前使用编辑字段节点进行修改）。
- 不映射：不进行任何数据映射。

选项#

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

请参阅 Method: spreadsheets.values.append | Google Sheets API 文档了解更多信息。

清空工作表#

使用此操作可清空工作表中的所有数据。输入以下参数：

连接凭据：创建或选择现有的 Google Sheets 凭据。
资源：选择 文档内的工作表。
操作：选择清空。
文档：选择包含要清空数据的工作表的电子表格。
- 选择 从列表 从下拉列表中选择电子表格标题，通过 URL 输入电子表格的 URL，或 通过 ID 输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
工作表：选择要清空数据的工作表。
- 选择 从列表 从下拉列表中选择工作表标题，通过 URL 输入工作表的 URL，通过 ID 输入 sheetId，或 通过名称 输入工作表标题。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
清空：选择要从工作表中清空的数据。
- 整个工作表：清空整个工作表的数据。开启 保留首行 以保留工作表的第一行。
- 特定行：清空特定行的数据。还需输入：
  - 起始行号：输入要清空的起始行号。
  - 要删除的行数：输入要清空的行数。1 仅清空 起始行号 中指定的行。
- 特定列：清空特定列的数据。还需输入：
  - 起始列：使用字母表示法输入要清空的起始列。
  - 要删除的列数：输入要清空的列数。1 仅清空 起始列 中指定的列。
- 特定范围：以 A1 表示法输入要清空数据的表格范围。

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

创建新工作表#

使用此操作可创建新工作表。输入以下参数：

连接凭据：创建或选择现有的 Google Sheets 凭据。
资源：选择 文档内工作表。
操作：选择创建。
文档：选择要创建新工作表的电子表格。
- 选择 从列表 以下拉列表中选择电子表格标题，选择 通过 URL 输入电子表格的网址，或选择 通过 ID 输入 spreadsheetId。
- 您可以在 Google Sheets 网址中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
标题：输入新工作表的标题。

选项#

隐藏：启用此选项可在界面中隐藏工作表。
从右到左：启用此选项可使用从右到左（RTL）工作表替代从左到右（LTR）工作表。
工作表 ID：输入工作表的 ID。
- 您可以在 Google Sheets 网址中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
工作表索引：默认情况下，新工作表位于电子表格中的最后位置。要覆盖此行为，请输入新工作表要使用的索引。当您在指定索引处添加工作表时，Google 会为之后的所有工作表递增索引。请参阅 Sheets | SheetProperties 文档以获取更多信息。
标签颜色：输入十六进制颜色代码或使用颜色选择器设置界面中标签的颜色。

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

删除工作表#

使用此操作可永久删除工作表。输入以下参数：

连接凭据：创建或选择现有的 Google Sheets 凭据。
资源：选择 文档内工作表。
操作：选择删除。
文档：选择包含要删除工作表的电子表格。
- 选择 从列表 从下拉列表中选择电子表格标题，通过 URL 输入电子表格的网址，或 通过 ID 输入 spreadsheetId。
- 您可以在 Google Sheets 网址中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
工作表：选择要删除的工作表。
- 选择 从列表 从下拉列表中选择工作表标题，通过 URL 输入工作表的网址，通过 ID 输入 sheetId，或 通过名称 输入工作表的名称。
- 您可以在 Google Sheets 网址中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。

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

删除行或列#

使用此操作可删除工作表中的行或列。输入以下参数：

连接凭据：创建或选择现有的 Google Sheets 凭据。
资源：选择 文档内工作表。
操作：选择 删除行或列。
文档：选择包含要删除行或列的工作表的电子表格。
- 选择 从列表 以从下拉列表中选择电子表格标题，通过 URL 以输入电子表格的 URL，或 通过 ID 以输入 spreadsheetId。
- 您可以在 Google Sheets URL 中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
工作表：选择要删除行或列的工作表。
- 选择 从列表 以从下拉列表中选择工作表标题，通过 URL 以输入工作表的 URL，通过 ID 以输入 sheetId，或 通过名称 以输入工作表的名称。
- 您可以在 Google Sheets URL 中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
起始行号 或 起始列：输入要开始删除的行号或列字母。
要删除的行数 或 要删除的列数：输入要删除的行数或列数。

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

获取行数据#

使用此操作从工作表中读取一行或多行数据。请填写以下参数：

连接凭据：创建或选择现有的 Google Sheets 凭据。
资源：选择 文档中的工作表。
操作：选择 获取行数据。
文档：选择包含目标工作表的数据表格。
- 选择 从列表 通过下拉菜单选择表格标题，通过 URL 输入表格链接，或 通过 ID 输入 spreadsheetId。
- 您可以在 Google Sheets 链接中找到 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
工作表：选择需要读取数据的工作表。
- 选择 从列表 通过下拉菜单选择工作表标题，通过 URL 输入工作表链接，通过 ID 输入 sheetId，或 通过名称 输入工作表名称。
- 您可以在 Google Sheets 链接中找到 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
筛选器：默认情况下，该节点将返回工作表中的所有行。设置筛选条件可返回限定结果集：
- 列：选择要搜索的工作表列。
- 值：输入要搜索的单元格值。您可以将输入数据参数拖拽至此。如果筛选条件匹配多行数据，n8n 将返回首个匹配结果。若需获取所有匹配行：
  1. 在选项下选择 添加选项 > 当筛选条件存在多个匹配项时。
  2. 将 当筛选条件存在多个匹配项时 设置为 返回所有匹配项。

选项#

数据在表格中的位置：使用此选项指定数据范围。默认情况下，n8n 将自动检测范围直至工作表的最后一行。
输出格式化：使用此选项选择 n8n 如何处理 Google Sheets 返回数据的格式。
常规格式化：
- 数值（未格式化）（默认）：n8n 会移除货币符号和其他特殊格式，数据类型保持为数字。
- 数值（已格式化）：n8n 按其在 Google Sheets 中的显示效果呈现数值（例如保留逗号或货币符号），同时将数据类型从数字转换为字符串。
- 公式：n8n 返回公式本身而不计算结果。例如，若单元格 B2 包含公式 =A2，n8n 会将 B2 的值返回为 =A2（文本形式）。更多信息请参阅关于日期和时间值 | Google Sheets。
日期格式化：更多信息请参阅DateTimeRenderOption | Google Sheets。 - 格式化文本（默认）：按 Google Sheets 中的显示效果呈现，具体取决于电子表格的区域设置。例如 2024年01月01日。 - 序列号：自 1899 年 12 月 30 日以来的天数。
当筛选器有多个匹配项时：设置为返回所有匹配项可获取多个匹配结果。默认仅返回首个匹配结果。

首行处理 n8n 将 Google Sheets 中的首行视为标题行，在读取所有行时不会返回该行。如需读取首行数据，请通过 Options 选项设置 Data Location on Sheet。更多信息请参阅 Method: spreadsheets.batchUpdate | Google Sheets API 文档。

更新行#

此操作用于更新表格中的现有行。该操作仅更新已存在的行，若要在表格中找不到匹配条目时追加行，请改用 追加或更新行 操作。

请填写以下参数：

连接凭据：创建或选择现有的 Google Sheets 凭据。
资源：选择 文档中的工作表。
操作：选择 更新行。
文档：选择包含要更新工作表的电子表格。
- 选择 从列表 通过下拉菜单选择电子表格标题，选择 通过 URL 输入电子表格链接，或选择 通过 ID 输入 spreadsheetId。
- 可在 Google Sheets 链接中获取 spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
工作表：选择要更新的工作表。
- 选择 从列表 通过下拉菜单选择工作表标题，通过 URL 输入工作表链接，通过 ID 输入 sheetId，或 通过名称 输入工作表标题。
- 可在 Google Sheets 链接中获取 sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
映射列模式：
- 手动映射每列：为每个列填写 要发送的值。
- 自动映射：n8n 会自动匹配 Google Sheets 中的列与输入数据。在此模式下，请确保输入数据字段与 Google Sheets 中的列完全一致（如有需要，可在此节点前使用编辑字段节点进行修改）。
- 不映射：不映射任何数据。

选项#

单元格格式 : 使用此选项选择单元格数据的格式化方式。更多信息请参考 Google Sheets API | CellFormat。
- 由 Google Sheets 格式化（默认）: n8n 将根据 Google Sheets 的默认设置格式化单元格中的文本和数字。
- 由 n8n 格式化 : 工作表中的新单元格将具有与 n8n 提供的输入数据相同的数据类型。
数据在工作表中的位置 : 当需要指定工作表中数据范围的位置时使用此选项。
- 标题行 : 指定包含列标题的行索引。
- 首行数据 : 指定实际数据开始的行索引。

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

On this page