如何在Google Sheet新增数据时自动触发指定Google Apps Script函数？

一、先修正现有脚本的问题 #

你当前的脚本存在两个核心问题：一是getRange("A")会获取整列数据，无法定位到新增行；二是缺少循环逻辑和重复提交防护。以下是优化后的脚本：

function submitNewEntriesToForm() {
  const formUrl = "替换为你的Google表单URL";
  const wrkBk = SpreadsheetApp.getActiveSpreadsheet();
  const wrkSht = wrkBk.getSheetByName("Sheet1");
  
  // 假设第一行是表头，从第二行开始处理数据
  const startRow = 2;
  const lastRow = wrkSht.getLastRow();
  // 取A到I列数据（I列用来标记是否已提交表单）
  const dataRange = wrkSht.getRange(startRow, 1, lastRow - startRow + 1, 9);
  const data = dataRange.getValues();

  data.forEach((row, index) => {
    const isSubmitted = row[8]; // I列对应索引8
    // 只处理未提交过的行
    if (!isSubmitted) {
      // 提取当前行各字段数据
      const [name, email, institute, qualification, linkedin, source, additional, track] = row;

      const datamap = {  
        "entry.1870580307": name,
        "emailAddress": email,
        "entry.172794055": institute,
        "entry.2041507911": qualification,
        "entry.981764969": linkedin,
        "entry.1599200340": source,
        "entry.835533968": additional,
        "entry.652935633": track
      };

      const options = {
        method: "post",
        payload: datamap
      };

      // 提交数据到表单
      UrlFetchApp.fetch(formUrl, options);
      
      // 标记当前行为已提交，避免重复处理
      wrkSht.getRange(startRow + index, 9).setValue(true);
    }
  });
}

脚本优化点说明 #

• 新增提交状态标记列（I列）：用来记录该行是否已提交，彻底避免重复提交。
• 批量读取数据：用getValues()一次性获取所有待处理行，比多次调用getRange()更高效。
• 解构赋值提取字段：简化行数据的提取逻辑，代码更简洁。

二、设置自动触发机制 #

由于你的场景包含手动新增数据和通过Google API写入数据，需要结合两种触发器覆盖所有情况：

1. 时间驱动触发器（必选，覆盖API写入场景） #

API写入数据不会触发电子表格的编辑类触发器，因此必须用时间驱动触发器定期检查新增条目：

• 打开目标Google Sheet，点击「扩展程序」→「Apps 脚本」进入编辑器。
• 点击左侧的「触发器」图标（闹钟样式）。
• 点击「添加触发器」：
  • 选择运行函数：submitNewEntriesToForm
  • 事件源：选择「时间驱动」
  • 事件类型：根据需求选择频率，比如「分钟计时器」→「每5分钟」，或「小时计时器」→「每小时」。
  • 完成设置后授权脚本所需权限。

2. 可安装 onChange 触发器（可选，加速手动新增响应） #

如果需要快速响应手动新增/批量编辑的情况，可添加该触发器：

• 在触发器页面点击「添加触发器」：
  • 选择运行函数：submitNewEntriesToForm
  • 事件源：选择「从电子表格」
  • 事件类型：选择「更改」
  • 保存并授权权限。
    注意：该触发器对API写入的支持不稳定，需和时间驱动触发器配合使用。

关键注意事项 #

• 确认表单的entry.xxx参数与实际表单字段完全匹配，若表单字段调整，需重新获取对应参数。
• 脚本授权时，需允许其访问你的Google Sheet和发送网络请求的权限。
• 时间驱动触发器的频率不要设置过高，避免触发Google Apps Script的配额限制。

内容的提问来源于stack exchange，提问作者Gaurav