Skip to content

Google Sheets 文档内的操作

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

该节点可用作AI工具

此节点可用于增强 AI 代理的功能。使用此方法时，许多参数可以自动设置，或使用 AI 指定的信息进行设置 - 更多信息请参阅AI 工具参数文档。

追加或更新行

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

输入以下参数：

  • 要连接的凭据：创建或选择现有的Google Sheets 凭据。
  • 资源：选择文档中的工作表。
  • 操作：选择附加或更新行。
  • 文档：选择包含要追加或更新行的工作表的电子表格。
    • 选择
    • “从列表”
    • 可从下拉列表中选择电子表格标题；选择
    • “按 URL”
    • 可输入电子表格的 URL；或
    • 选择“按 ID”
    • 可输入
    • 。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 工作表：选择要追加或更新行的工作表。
    • 选择
    • “从列表”
    • 可从下拉列表中选择工作表标题；选择
    • “按 URL”
    • 可输入工作表的 URL；
    • 选择“按 ID”
    • 可输入
    • ；或
    选择“
    • 按名称”
    • 可输入工作表标题。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 映射列模式：
    • 手动映射每列
    • ：
    为每列输入
    • 要发送的值
    • 。
    • 自动映射
    • ：n8n 会自动查找与 Google 表格中的列匹配的传入数据。在此模式下，请确保传入的数据字段与 Google 表格中的列相同。（如果需要，请使用
    此节点前的
    • 节点进行更改。）
    • 无
    • ：不映射任何数据。

选项

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

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

追加行

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

输入以下参数：

  • 要连接的凭据：创建或选择现有的Google Sheets 凭据。
  • 资源：选择文档中的工作表。
  • 操作：选择追加行。
  • 文档：选择要添加行的电子表格。
    • 选择
    • “从列表”从
    • 下拉列表中选择电子表格标题，
    • 选择“按 URL”
    • 输入电子表格的 URL，或
    • 选择“按 ID”
    • 输入
    • 。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 工作表：选择要添加行的工作表。
    • 选择
    • “从列表”
    • 从下拉列表中选择工作表标题，选择
    • “按 URL”
    • 输入工作表的 URL，
    • 选择“按 ID”
    • 输入
    • ，或
    • 选择“按名称”
    • 输入工作表标题。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 映射列模式：
    • 手动映射每列
    • ：
    • 查找要更新的行时，
    选择
    • 要匹配的列
    。输入
    • 每列
    • 要发送的值
    。
    • 自动映射
    • ：n8n 会自动查找与 Google 表格中的列匹配的传入数据。在此模式下，请确保传入的数据字段与 Google 表格中的列相同。（如果需要，请使用
    此节点前的
    • 节点进行更改。）
    • 无
    • ：不映射任何数据。

选项

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

请参阅方法：spreadsheets.values.append | Google Sheets API 文档以获取更多信息。

清除工作表

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

输入以下参数：

  • 要连接的凭据：创建或选择现有的Google Sheets 凭据。
  • 资源：选择文档中的工作表。
  • 操作：选择清除。
  • 文档：选择包含要清除数据的工作表的电子表格。
    • 选择
    • “从列表”
    • 可从下拉列表中选择电子表格标题；选择
    • “按 URL”
    • 可输入电子表格的 URL；或
    • 选择“按 ID”
    • 可输入
    • 。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    • 。
  • 工作表：选择要清除数据的工作表。
    • 选择
    • “从列表”
    • 可从下拉列表中选择工作表标题；选择
    • “按 URL”
    • 可输入工作表的 URL；
    • 选择“按 ID”
    • 可输入
    • ；或
    • 选择“按名称”
    • 可输入工作表标题。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 清除：选择要从工作表清除的数据。
    • 整张工作表
    • ：清除整张工作表的数据。 打开
    • 保留首行
    • 以保留工作表的第一行。
    • 特定行
    • ：清除特定行的数据。 还要输入：
      • 起始行号
      • ：输入要清除的第一个行号。
      • 要删除的行数
      • ：输入要清除的行数。
    仅清除
      • 起始行号
      • 中的行的数据
      • 。
    • 特定列
    • ：清除特定列的数据。 还要输入：
      • 起始列
      • ：使用字母符号输入要清除的第一列。
      • 要删除的列数
      • ：输入要清除的列数。
      • 仅清除
      • 起始列
    中的数据
      • 。
    • 特定范围
    ：以
    • 输入要清除数据的表格范围
    • 。

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

创建新工作表

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

输入以下参数：

  • 要连接的凭据：创建或选择现有的Google Sheets 凭据。
  • 资源：选择文档中的工作表。
  • 操作：选择创建。
  • 文档：选择要在其中创建新工作表的电子表格。
    • 选择
    • “从列表”
    • 从下拉列表中选择电子表格标题，
    • 选择“按 URL”
    • 输入电子表格的 URL，或
    • 选择“按 ID”
    • 输入
    • 。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 标题：输入新工作表的标题。

选项

  • 隐藏：打开此选项可使工作表在 UI 中隐藏。
  • 从右到左：打开此选项可使用 RTL 表而不是 LTR 表。
  • 工作表 ID ：输入工作表的 ID。您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
  • 工作表索引：默认情况下，新工作表是电子表格中的最后一个工作表。要覆盖此行为，请输入您希望新工作表使用的索引。当您在给定索引处添加工作表时，Google 会递增所有后续工作表的索引。有关更多信息，请参阅工作表 | SheetProperties文档。
  • 选项卡颜色：输入十六进制代码颜色或使用颜色选择器设置 UI 中选项卡的颜色。

请参阅方法：spreadsheets.batchUpdate | Google Sheets API 文档以了解更多信息。

删除工作表

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

输入以下参数：

  • 要连接的凭据：创建或选择现有的Google Sheets 凭据。
  • 资源：选择文档中的工作表。
  • 操作：选择删除。
  • 文档：选择包含要删除工作表的电子表格。
    • 选择
    • “从列表”
    • 可从下拉列表中选择电子表格标题；
    • 选择“按 URL”
    • 可输入电子表格的 URL；或
    • 选择“按 ID”
    • 可输入
    • 。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    • 。
  • 工作表：选择要删除的工作表。
    • 选择
    • “从列表”
    • 可从下拉列表中选择工作表标题；选择
    • “按 URL”
    • 可输入工作表的 URL；
    • 选择“按 ID”
    • 可输入
    • ；或
    • 选择“按名称”
    • 可输入工作表的名称。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。

请参阅方法：spreadsheets.batchUpdate | Google Sheets API 文档以了解更多信息。

删除行或列

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

输入以下参数：

  • 要连接的凭据：创建或选择现有的Google Sheets 凭据。
  • 资源：选择文档中的工作表。
  • 操作：选择删除行或者删除列。
  • 文档：选择包含要从中删除行或列的工作表的电子表格。
    • 选择
    • “从列表”
    • 可从下拉列表中选择电子表格标题；
    • 选择“按 URL”
    • 可输入电子表格的 URL；或
    • 选择“按 ID
    ”
    • 可输入
    • 。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 工作表：选择要删除行或列的工作表。
    • 选择
    • “从列表”
    • 可从下拉列表中选择工作表标题；
    • 选择“按 URL”
    • 可输入工作表的 URL；
    • 选择“按 ID”
    • 可输入
    • ；或
    • 选择“按名称”
    • 可输入工作表的名称。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 起始行号或起始列：输入开始删除的行号或列字母。
  • 要删除的行数或要删除的列数：输入要删除的行数或列数。

请参阅方法：spreadsheets.batchUpdate | Google Sheets API 文档以了解更多信息。

获取行

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

输入以下参数：

  • 要连接的凭据：创建或选择现有的Google Sheets 凭据。
  • 资源：选择文档中的工作表。
  • 操作：选择获取行。
  • 文档：选择包含要从中获取行的工作表的电子表格。
    • 选择
    • “从列表”
    • 可从下拉列表中选择电子表格标题；
    • 选择“按 URL”
    • 可输入电子表格的 URL；或
    • 选择“按 ID”
    • 可输入
    • 。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 工作表：选择要读取行的工作表。
    • 选择
    • “从列表”
    • 可从下拉列表中选择工作表标题；选择
    • “按 URL”
    • 可输入工作表的 URL；
    • 选择“按 ID”
    • 可输入
    • ；或
    • 选择“按名称”
    • 可输入工作表的名称。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 过滤器：默认情况下，节点返回工作表中的所有行。设置过滤器以返回有限的结果集：
    • 列
    • ：选择工作表中要搜索的列。
    • 值
    • ：输入要搜索的单元格值。您可以将输入数据参数拖到这里。如果过滤器匹配多行，n8n 将返回第一个结果。如果您想要所有匹配的行：
    在
      1. “选项”
      1. 下
      1. ，选择
      1. “添加选项”
      1. >
      1. “当过滤器有多个匹配项时
      1. ”。
      1. 将“当过滤器有多个匹配项时”
      1. 更改
      1. 为“返回
      1. 所有匹配项”
      1. 。

选项

  • 工作表上的数据位置：使用此选项指定数据范围。默认情况下，n8n 将自动检测范围，直到工作表的最后一行。
  • 输出格式：使用此选项选择 n8n 如何格式化 Google 表格返回的数据。
  • 常规格式：
    • 值（未格式化）
    • （默认）：n8n 会删除货币符号和其他特殊格式。数据类型保留为数字。
    • 值（格式化）
    • ：n8n 通过将数据类型从数字转换为字符串，显示 Google 表格中显示的值（例如，保留逗号或货币符号）。
    • 公式
    • ：n8n 返回公式。它不计算公式的输出。例如，如果单元格 B2 包含公式
    • ，则 n8n 会以文本形式返回 B2 的值
    • 。有关更多信息，请参阅
    • 。
  • 日期格式：请参阅DateTimeRenderOption | Google 表格了解更多信息。-格式化文本（默认）：与 Google 表格中显示的格式相同，具体取决于电子表格的语言环境。例如：-序列号：自 1899 年 12 月 30 日以来的天数。
  • 当过滤器有多个匹配项时：设置为“返回所有匹配项”以获取多个匹配项。默认情况下，仅返回第一个结果。

第一行

n8n 将 Google Sheet 中的第一行视为标题行，并且在读取所有行时不会返回该行。如果您想读取第一行，请使用“选项”设置Sheet 上的数据位置。

请参阅方法：spreadsheets.batchUpdate | Google Sheets API 文档以了解更多信息。

更新行

使用此操作可更新工作表中的现有行。此操作仅更新现有行。如果在工作表中找不到匹配的条目，则需要追加行，请使用“追加”或“更新行”操作。

输入以下参数：

  • 要连接的凭据：创建或选择现有的Google Sheets 凭据。
  • 资源：选择文档中的工作表。
  • 操作：选择更新行。
  • 文档：选择包含要更新工作表的电子表格。
    • 选择
    • “从列表”
    • 可从下拉列表中选择电子表格标题；
    • 选择“按 URL”
    • 可输入电子表格的 URL；或
    • 选择“按 ID”
    • 可输入
    • 。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    • 。
  • 工作表：选择要更新的工作表。
    • 选择
    • “从列表”
    • 可从下拉列表中选择工作表标题；
    • 选择“按 URL”
    • 可输入工作表的 URL；
    • 选择“按 ID”
    • 可输入
    • ；或
    • 选择“按名称”
    • 可输入工作表标题。
    您可以
    • 在 Google 表格 URL 中
    • 找到
    ：
    • 。
  • 映射列模式：
    • 手动映射每列
    • ：
    为每列输入
    • 要发送的值
    • 。
    • 自动映射
    • ：n8n 会自动查找与 Google 表格中的列匹配的传入数据。在此模式下，请确保传入的数据字段与 Google 表格中的列相同。（如果需要，请使用
    此节点前的
    • 节点进行更改。）
    • 无
    • ：不映射任何数据。

选项

  • 单元格格式：使用此选项选择如何格式化单元格中的数据。更多信息，请参阅Google Sheets API | CellFormat 。
    • 设置 Google Sheets 格式
    • （默认）：n8n 根据 Google Sheets 的默认设置格式化单元格中的文本和数字。
    • 设置 n8n 格式
    • ：工作表中的新单元格将具有与 n8n 提供的输入数据相同的数据类型。
  • 工作表上的数据位置：当您需要指定工作表上数据范围的位置时，请使用此选项。
    • 标题行
    • ：指定包含列标题的行索引。
    • 第一个数据行
    • ：指定实际数据起始的行索引。

请参阅方法：spreadsheets.batchUpdate | Google Sheets API 文档以了解更多信息。