n8n 中文文档

文档内的工作表操作

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

提示

This node can be used as an AI tool 该节点可用作AI工具

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

追加或更新行

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

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Google 表格凭据。
  • Resource 资源:选择Sheet Within Document 文档内的工作表。
  • Operation 操作:选择Append or Update Row 追加或更新行。
  • Document 文件:选择包含要追加或更新行的工作表的电子表格。
  • 选择 From list 来自列表 从下拉列表中选择电子表格标题,选择 By URL 通过网址 输入电子表格的 URL,或选择 By ID 输入 spreadsheetId。
  • 您可以在 Google 表格 URL 中找到 spreadsheetId:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet 板材:选择要追加或更新行的工作表。
  • 选择 From list 来自列表 从下拉列表中选择工作表标题,选择 By URL 通过网址 输入工作表的 url,选择 By ID 输入 sheetId,或选择 By Name 按名称 输入工作表标题。
  • 您可以在 Google 表格 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 表格中的列匹配的传入数据。在此模式下,请确保传入的数据字段与 Google 表格中的列相同。 (如果需要,请在此节点之前使用 编辑字段 节点来更改它们。)
  • Nothing 什么都没有:不映射任何数据。

选项

  • Cell Format 单元格格式:使用此选项选择如何格式化单元格中的数据。请参阅Google Sheets API |单元格格式 了解更多信息。
    • Let Google Sheets format 让 Google 表格格式化(默认):n8n 根据 Google 表格的默认设置设置单元格中文本和数字的格式。
    • Let n8n format 让n8n格式化:工作表中的新单元格将具有与 n8n 提供的输入数据相同的数据类型。
  • Data Location on Sheet 工作表上的数据位置:当您需要在工作表上指定数据范围时,请使用此选项。
    • Header Row 标题行:指定包含列标题的行索引。
    • First Data Row 第一个数据行:指定实际数据开始的行索引。
  • Handling extra fields in input 处理输入中的额外字段:使用 Mapping Column Mode > Map Automatically 映射列模式 > 自动映射 时,使用此选项决定如何处理与工作表中任何现有列不匹配的输入数据中的字段。
    • Insert in New Column(s) 插入新列(默认):为任何额外数据添加新列。
    • Ignore Them 忽略他们:忽略与现有列不匹配的额外数据。
    • Error 错误:抛出错误并停止执行。
  • Use Append 使用追加:打开此选项可使用 Google API 附加端点 添加新数据行。
    • 默认情况下,n8n 附加空行或空列,然后添加新数据。这种方法可以确保数据对齐,但效率可能较低。使用追加端点可以最大限度地减少 API 调用数量并简化流程,从而提高性能。但如果现有的工作表数据存在不一致的情况,例如行和列之间存在间隙或中断,n8n 可能会将新数据添加到错误的位置,从而导致错位问题。
    • 当性能优先并且工作表中的数据结构一致且无间隙时,请使用此选项。

请参考 Method: spreadsheets.values.update | Google Sheets{:target=_blank .external-link} API 文档获取更多信息。

追加行

使用此操作可在工作表中的数据末尾附加新行。

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Google 表格凭据。
  • Resource 资源:选择Sheet Within Document 文档内的工作表。
  • Operation 操作:选择Append Row 追加行。
  • Document 文件:选择包含要追加行的工作表的电子表格。
  • 选择 From list 来自列表 从下拉列表中选择电子表格标题,选择 By URL 通过网址 输入电子表格的 URL,或选择 By ID 输入 spreadsheetId。
  • 您可以在 Google 表格 URL 中找到 spreadsheetId:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet 板材:选择要追加行的工作表。
  • 选择 From list 来自列表 从下拉列表中选择工作表标题,选择 By URL 通过网址 输入工作表的 url,选择 By ID 输入 sheetId,或选择 By Name 按名称 输入工作表标题。
  • 您可以在 Google 表格 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 表格中的列匹配的传入数据。在此模式下,请确保传入的数据字段与 Google 表格中的列相同。 (如果需要,请在此节点之前使用 编辑字段 节点来更改它们。)
  • Nothing 什么都没有:不映射任何数据。

选项

  • Cell Format 单元格格式:使用此选项选择如何格式化单元格中的数据。请参阅Google Sheets API |单元格格式 了解更多信息。
    • Let Google Sheets format 让 Google 表格格式化(默认):n8n 根据 Google 表格的默认设置设置单元格中文本和数字的格式。
    • Let n8n format 让n8n格式化:工作表中的新单元格将具有与 n8n 提供的输入数据相同的数据类型。
  • Data Location on Sheet 工作表上的数据位置:当您需要在工作表上指定数据范围时,请使用此选项。
    • Header Row 标题行:指定包含列标题的行索引。
    • First Data Row 第一个数据行:指定实际数据开始的行索引。
  • Handling extra fields in input 处理输入中的额外字段:使用 Mapping Column Mode > Map Automatically 映射列模式 > 自动映射 时,使用此选项决定如何处理与工作表中任何现有列不匹配的输入数据中的字段。
    • Insert in New Column(s) 插入新列(默认):为任何额外数据添加新列。
    • Ignore Them 忽略他们:忽略与现有列不匹配的额外数据。
    • Error 错误:抛出错误并停止执行。
  • Use Append 使用追加:打开此选项可使用 Google API 附加端点 添加新数据行。
    • 默认情况下,n8n 附加空行或空列,然后添加新数据。这种方法可以确保数据对齐,但效率可能较低。使用追加端点可以最大限度地减少 API 调用数量并简化流程,从而提高性能。但如果现有的工作表数据存在不一致的情况,例如行和列之间存在间隙或中断,n8n 可能会将新数据添加到错误的位置,从而导致错位问题。
    • 当性能优先并且工作表中的数据结构一致且无间隙时,请使用此选项。

请参考 Method: spreadsheets.values.append | Google Sheets{:target=_blank .external-link} API 文档获取更多信息。

清除一张表

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

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Google 表格凭据。
  • Resource 资源:选择Sheet Within Document 文档内的工作表。
  • Operation 操作:选择Clear 清除。
  • Document 文件:选择包含要从中清除数据的工作表的电子表格。
  • 选择 From list 来自列表 从下拉列表中选择电子表格标题,选择 By URL 通过网址 输入电子表格的 URL,或选择 By ID 输入 spreadsheetId。
  • 您可以在 Google 表格 URL 中找到 spreadsheetId:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet 板材:选择要清除数据的工作表。
  • 选择 From list 来自列表 从下拉列表中选择工作表标题,选择 By URL 通过网址 输入工作表的 url,选择 By ID 输入 sheetId,或选择 By Name 按名称 输入工作表标题。
  • 您可以在 Google 表格 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{:target=_blank .external-link} API 文档获取更多信息。

创建一个新工作表

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

输入这些参数:

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

选项

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

请参考 Method: spreadsheets.batchUpdate | Google Sheets{:target=_blank .external-link} API 文档获取更多信息。

删除一张表

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

输入这些参数:

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

请参考 Method: spreadsheets.batchUpdate | Google Sheets{:target=_blank .external-link} API 文档获取更多信息。

删除行或列

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

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Google 表格凭据。
  • Resource 资源:选择Sheet Within Document 文档内的工作表。
  • Operation 操作:选择Delete Rows or Columns 删除行或列。
  • Document 文件:选择包含要从中删除行或列的工作表的电子表格。
  • 选择 From list 来自列表 从下拉列表中选择电子表格标题,选择 By URL 通过网址 输入电子表格的 URL,或选择 By ID 输入 spreadsheetId。
  • 您可以在 Google 表格 URL 中找到 spreadsheetId:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet 板材:选择要删除行或列的工作表。
  • 选择 From list 来自列表 从下拉列表中选择工作表标题,选择 By URL 通过网址 输入工作表的 url,选择 By ID 输入 sheetId,或选择 By Name 按名称 输入工作表名称。
  • 您可以在 Google 表格 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{:target=_blank .external-link} API 文档获取更多信息。

获取行

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

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Google 表格凭据。
  • Resource 资源:选择Sheet Within Document 文档内的工作表。
  • Operation 操作:选择Get Row(s) 获取行。
  • Document 文件:选择包含要从中获取行的工作表的电子表格。
  • 选择 From list 来自列表 从下拉列表中选择电子表格标题,选择 By URL 通过网址 输入电子表格的 URL,或选择 By ID 输入 spreadsheetId。
  • 您可以在 Google 表格 URL 中找到 spreadsheetId:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet 板材:选择要从中读取行的工作表。
  • 选择 From list 来自列表 从下拉列表中选择工作表标题,选择 By URL 通过网址 输入工作表的 url,选择 By ID 输入 sheetId,或选择 By Name 按名称 输入工作表名称。
  • 您可以在 Google 表格 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 返回所有匹配项。

选项

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

提示

First row 第一排

n8n 将 Google 表格中的第一行视为标题行,并且在读取所有行时不返回它。如果要读取第一行,请使用Options 选项设置Data Location on Sheet 工作表上的数据位置。

请参考 Method: spreadsheets.batchUpdate | Google Sheets{:target=_blank .external-link} API 文档获取更多信息。

更新行

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

输入这些参数:

  • Credential to connect with 连接凭据:创建或选择现有的 Google 表格凭据。
  • Resource 资源:选择Sheet Within Document 文档内的工作表。
  • Operation 操作:选择Update Row 更新行。
  • Document 文件:选择包含要更新的工作表的电子表格。
  • 选择 From list 来自列表 从下拉列表中选择电子表格标题,选择 By URL 通过网址 输入电子表格的 URL,或选择 By ID 输入 spreadsheetId。
  • 您可以在 Google 表格 URL 中找到 spreadsheetId:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet 板材:选择您要更新的工作表。
  • 选择 From list 来自列表 从下拉列表中选择工作表标题,选择 By URL 通过网址 输入工作表的 url,选择 By ID 输入 sheetId,或选择 By Name 按名称 输入工作表标题。
  • 您可以在 Google 表格 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 表格中的列匹配的传入数据。在此模式下,请确保传入的数据字段与 Google 表格中的列相同。 (如果需要,请在此节点之前使用 编辑字段 节点来更改它们。)
  • Nothing 什么都没有:不映射任何数据。

选项

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

参考方法:spreadsheets.batchUpdate | Google Sheets API 文档以获取更多信息。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。