跳至内容

Google Sheets 文档内工作表操作#

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

该节点可用作AI工具

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

追加或更新行#

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

输入以下参数：

  • 连接凭证: 创建或选择现有的Google Sheets凭证。
  • 资源: 选择文档中的工作表。
  • 操作: 选择追加或更新行.
  • Document: Choose a spreadsheet that contains the sheet you want to append or update row(s) to.
    • 选择从列表以下拉菜单中选择电子表格标题，通过URL输入电子表格的URL，或通过ID输入spreadsheetId。
    • 您可以在Google Sheets的URL中找到spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet: Choose a sheet you want to append or update row(s) to.
    • 选择从列表在下拉菜单中选择工作表标题，通过URL输入工作表的URL，通过ID输入sheetId，或通过名称输入工作表标题。
    • 您可以在Google表格的URL中找到sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
  • Mapping Column Mode:
    • 手动映射每列: 为每列输入要发送的值。
    • 自动映射: n8n会自动查找与Google表格列匹配的传入数据。在此模式下，请确保传入数据字段与Google表格中的列相同。（如需更改，可在此节点前使用Edit Fields节点进行调整。）
    • 无: 不映射任何数据。

选项#

  • Cell Format: Use this option to choose how to format the data in cells. Refer to Google Sheets API | CellFormat for more information.
    • 使用Google表格格式（默认）：n8n会根据Google表格的默认设置对单元格中的文本和数字进行格式化。
    • 让n8n格式化: 您表格中的新单元格将具有与n8n提供的输入数据相同的数据类型。
  • Data Location on Sheet: Use this option when you need to specify the data range on your sheet.
    • 标题行: 指定包含列标题的行索引。
    • 首行数据: 指定实际数据开始的行索引。
  • Handling extra fields in input: When using Mapping Column Mode > Map Automatically, use this option to decide how to handle fields in the input data that don't match any existing columns in the sheet.
    • 插入到新列 (默认): 为任何额外数据添加新列。
    • 忽略它们: 忽略与现有列不匹配的额外数据。
    • 错误: 抛出错误并停止执行。
  • Use Append: Turn on this option to use the Google API 追加端点 for adding new data rows.
    • 默认情况下，n8n会先追加空行或空列再添加新数据。这种方式能确保数据对齐但效率可能较低。使用append端点可以通过减少API调用次数和简化流程来提升性能。但如果现有表格数据存在行/列间存在间隙或中断等不一致情况，n8n可能会将新数据添加到错误位置，导致对齐问题。
    • 当性能是优先考虑因素且表格中的数据结构一致无空缺时，使用此选项。

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

追加行#

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

输入以下参数：

  • 连接凭证: 创建或选择现有的Google Sheets凭证。
  • 资源: 选择文档中的工作表。
  • 操作: 选择追加行.
  • Document: Choose a spreadsheet with the sheet you want to append a row to.
    • 选择从列表以下拉菜单中选择电子表格标题，通过URL输入电子表格的URL，或通过ID输入spreadsheetId。
    • 您可以在Google Sheets的URL中找到spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet: Choose a sheet you want to append a row to.
    • 选择从列表在下拉菜单中选择工作表标题，通过URL输入工作表的URL，通过ID输入sheetId，或通过名称输入工作表标题。
    • 您可以在Google表格的URL中找到sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
  • Mapping Column Mode:
    • 手动映射每列: 在查找要更新的行时选择匹配列。为每列输入要发送的值。
    • 自动映射: n8n会自动查找与Google表格列匹配的传入数据。在此模式下，请确保传入数据字段与Google表格中的列相同。（如需更改，可在此节点前使用Edit Fields节点进行调整。）
    • 无: 不映射任何数据。

选项#

  • Cell Format: Use this option to choose how to format the data in cells. Refer to Google Sheets API | CellFormat for more information.
    • 使用Google表格格式（默认）：n8n会根据Google表格的默认设置对单元格中的文本和数字进行格式化。
    • 让n8n格式化: 您表格中的新单元格将具有与n8n提供的输入数据相同的数据类型。
  • Data Location on Sheet: Use this option when you need to specify the data range on your sheet.
    • 标题行: 指定包含列标题的行索引。
    • 首行数据: 指定实际数据开始的行索引。
  • Handling extra fields in input: When using Mapping Column Mode > Map Automatically, use this option to decide how to handle fields in the input data that don't match any existing columns in the sheet.
    • 插入到新列 (默认): 为任何额外数据添加新列。
    • 忽略它们: 忽略与现有列不匹配的额外数据。
    • 错误: 抛出错误并停止执行。
  • Use Append: Turn on this option to use the Google API 追加端点 for adding new data rows.
    • 默认情况下，n8n会先追加空行或空列，然后再添加新数据。这种方法可以确保数据对齐，但效率可能较低。使用append端点可以通过减少API调用次数和简化流程来提高性能。但如果现有工作表数据存在不一致情况（例如行与列之间存在间隙或中断），n8n可能会将新数据添加到错误位置，从而导致对齐问题。
    • 当性能是优先考虑因素且表格中的数据结构一致无间隙时，使用此选项。

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

清空工作表#

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

输入以下参数：

  • 连接凭证: 创建或选择现有的Google Sheets凭证。
  • 资源: 选择文档中的工作表。
  • 操作: 选择清除。
  • Document: Choose a spreadsheet with the sheet you want to clear data from.
    • 选择从列表以下拉菜单中选择电子表格标题，通过URL输入电子表格的URL，或通过ID输入spreadsheetId。
    • 您可以在Google Sheets的URL中找到spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet: Choose a sheet you want to clear data from.
    • 选择从列表在下拉菜单中选择工作表标题，通过URL输入工作表的URL，通过ID输入sheetId，或通过名称输入工作表标题。
    • 您可以在Google表格的URL中找到sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
  • Clear: Select what data you want cleared from the sheet.
    • 整个工作表: 清除整个工作表的数据。开启保留首行选项可保留工作表的第一行。
    • Specific Rows: Clear data from specific rows. Also enter:
      • 起始行号: 输入您想要清除的第一行行号。
      • 要删除的行数: 输入要清除的行数。1表示仅清除起始行号中指定的行数据。
    • Specific Columns: Clear data from specific columns. Also enter:
      • 起始列: 输入您要清除的第一个列，使用字母表示法。
      • 要删除的列数: 输入要清空的列数。1表示仅清空起始列中的数据。
    • 特定范围: 输入要清除数据的表格范围，使用A1表示法。

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

创建新工作表#

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

输入以下参数：

  • 连接凭证: 创建或选择现有的Google Sheets凭证。
  • 资源: 选择文档中的工作表。
  • 操作: 选择创建。
  • Document: Choose a spreadsheet in which you want to create a new sheet.
    • 选择从列表以下拉菜单中选择电子表格标题，通过URL输入电子表格的URL，或通过ID输入spreadsheetId。
    • 您可以在Google Sheets的URL中找到spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • 标题: 输入新工作表的标题。

选项#

  • 隐藏: 开启此选项可在用户界面中保持工作表隐藏状态。
  • 从右到左: 开启此选项将使用RTL表格而非LTR表格。
  • Sheet ID: Enter the ID of the sheet.
    • 您可以在Google表格的URL中找到sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
  • 工作表索引: 默认情况下，新工作表会添加在电子表格的最后一页。要覆盖此行为，请输入新工作表要使用的索引。当您在指定索引处添加工作表时，Google会递增后续所有工作表的索引。更多信息请参阅Sheets | SheetProperties文档。
  • 标签颜色: 输入十六进制颜色代码或使用颜色选择器来设置界面中标签的颜色。

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

删除工作表#

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

输入以下参数：

  • 连接凭证: 创建或选择现有的Google Sheets凭证。
  • 资源: 选择文档中的工作表。
  • 操作: 选择删除.
  • Document: Choose a spreadsheet that contains the sheet you want to delete.
    • 选择从列表以下拉菜单中选择电子表格标题，通过URL输入电子表格的URL，或通过ID输入spreadsheetId。
    • 您可以在Google Sheets的URL中找到spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet: Choose the sheet you want to delete.
    • 选择从列表在下拉菜单中选择工作表标题，通过URL输入工作表的网址，通过ID输入sheetId，或通过名称输入工作表的名称。
    • 您可以在Google表格的URL中找到sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。

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

删除行或列#

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

输入以下参数：

  • 连接凭证: 创建或选择现有的Google Sheets凭证。
  • 资源: 选择文档中的工作表。
  • 操作: 选择删除行或列.
  • Document: Choose a spreadsheet that contains the sheet you want to delete rows or columns from.
    • 选择从列表以下拉菜单中选择电子表格标题，通过URL输入电子表格的URL，或通过ID输入spreadsheetId。
    • 您可以在Google Sheets的URL中找到spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet: Choose the sheet in which you want to delete rows or columns.
    • 选择从列表在下拉菜单中选择工作表标题，通过URL输入工作表的URL，通过ID输入sheetId，或通过名称输入工作表名称。
    • 您可以在Google表格的URL中找到sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
  • 起始行号 或 起始列: 输入要开始删除的行号或列字母。
  • 要删除的行数 或 要删除的列数: 输入要删除的行数或列数。

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

获取行数据#

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

输入以下参数：

  • 连接凭证: 创建或选择现有的Google Sheets凭证。
  • 资源: 选择文档中的工作表。
  • 操作: 选择 获取行.
  • Document: Choose a spreadsheet that contains the sheet you want to get rows from.
    • 选择从列表以下拉菜单中选择电子表格标题，通过URL输入电子表格的URL，或通过ID输入spreadsheetId。
    • 您可以在Google Sheets的URL中找到spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet: Choose a sheet you want to read rows from.
    • 选择从列表在下拉菜单中选择工作表标题，通过URL输入工作表的URL，通过ID输入sheetId，或通过名称输入工作表的名称。
    • 您可以在Google表格的URL中找到sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
  • Filters: By default, the node returns all rows in the sheet. Set filters to return a limited set of results:
    • 列: 选择工作表中要搜索的列。
    • Value: Enter a cell value to search for. You can drag input data parameters here. If your filter matches multiple rows, n8n returns the first result. If you want all matching rows:
      1. 在选项下，选择添加选项 > 当筛选器有多个匹配项时。
      2. 将当过滤器有多个匹配项时改为返回所有匹配项。

选项#

  • 表格中的数据位置: 使用此选项可指定数据范围。默认情况下，n8n会自动检测范围直到工作表的最后一行。
  • 输出格式: 使用此选项选择n8n如何格式化Google Sheets返回的数据。
  • General Formatting:
    • 数值（未格式化）（默认）：n8n会移除货币符号和其他特殊格式。数据类型仍保持为数字。
    • 格式化值: n8n会通过将数据类型从数字转换为字符串，按照这些值在Google表格中的显示方式来呈现（例如保留逗号或货币符号）。
    • 公式: n8n 返回公式本身，而不会计算公式的输出结果。例如，如果单元格 B2 包含公式 =A2，n8n 会将 B2 的值返回为文本形式的 =A2。更多信息请参考 About date & time values | Google Sheets。
  • 日期格式化: 更多信息请参考DateTimeRenderOption | Google Sheets。 - 格式化文本 (默认): 以Google表格中显示的格式为准，取决于电子表格的区域设置。例如01/01/2024。 - 序列号: 自1899年12月30日起的天数。
  • 当过滤器有多个匹配项时：设置为返回所有匹配项以获取多个匹配结果。默认情况下仅返回第一个结果。

第一行

n8n将Google表格中的第一行视为标题行，在读取所有行时不会返回该行。如需读取第一行，请使用选项设置表格上的数据位置。

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

更新行#

使用此操作可更新表格中的现有行。此操作仅更新现有行。若要在表格中未找到匹配项时追加行，请改用追加或更新行操作。

输入以下参数：

  • 连接凭证: 创建或选择现有的Google Sheets凭证。
  • 资源: 选择文档中的工作表。
  • 操作: 选择 更新行.
  • Document: Choose a spreadsheet with the sheet you want to update.
    • 选择从列表以下拉菜单中选择电子表格标题，通过URL输入电子表格的URL，或通过ID输入spreadsheetId。
    • 您可以在Google Sheets的URL中找到spreadsheetId：https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0。
  • Sheet: Choose a sheet you want to update.
    • 选择从列表在下拉菜单中选择工作表标题，通过URL输入工作表的URL，通过ID输入sheetId，或通过名称输入工作表标题。
    • 您可以在Google表格的URL中找到sheetId：https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId。
  • Mapping Column Mode:
    • 手动映射每列: 为每列输入要发送的值。
    • 自动映射: n8n会自动查找与Google表格列匹配的传入数据。在此模式下，请确保传入数据字段与Google表格中的列相同。（如需更改，可在此节点前使用Edit Fields节点进行调整。）
    • 无: 不映射任何数据。

选项#

  • Cell Format: Use this option to choose how to format the data in cells. Refer to Google Sheets API | CellFormat for more information.
    • 使用Google表格格式（默认）：n8n会根据Google表格的默认设置对单元格中的文本和数字进行格式化。
    • 让n8n格式化: 您表格中的新单元格将具有与n8n提供的输入数据相同的数据类型。
  • Data Location on Sheet: Use this option when you need to specify where the data range on your sheet.
    • 标题行: 指定包含列标题的行索引。
    • 首行数据: 指定实际数据开始的行索引。

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

优云智算