如何让Google Sheets Apps Script函数在API（Zapier）更新行时触发？

核心原因 #

onEdit是Google Apps Script的简单触发器，仅在用户手动编辑工作表时触发，通过API（如Zapier）、脚本或导入操作修改表格时不会触发——这就是手动更新有效、API更新无效的根本原因。另外你尝试的时间触发器失败，大概率是因为原代码依赖onEdit传入的事件对象e，而时间触发器运行时无该对象，导致代码报错。

解决方案：改用可安装onChange触发器 #

可安装的onChange触发器会响应所有表格修改事件（包括API更新、脚本修改等），需手动在脚本编辑器中配置。以下是完整修改步骤：

1. 调整代码逻辑

修改原代码适配onChange事件，并优化性能（减少重复getRange调用，改用批量读写提升效率）：

function incrementNumber(targetSheet, updatedRow) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet1 = ss.getSheetByName("Sheet1");
  const sheet2 = targetSheet;
  
  // 批量读取Sheet1数据，减少API调用
  const data1 = sheet1.getDataRange().getValues();
  const updatedValue = sheet2.getRange(updatedRow, 1).getValue(); // A列值
  const updatedDate = sheet2.getRange(updatedRow, 2).getValue(); // B列日期
  
  let matchFound = false;
  // 遍历Sheet1查找匹配项
  for (let i = 0; i < data1.length; i++) {
    if (data1[i][0] === updatedValue) {
      matchFound = true;
      // 更新计数：原计数+1，默认0
      const currentCount = data1[i][1] || 0;
      sheet1.getRange(i + 1, 2).setValue(currentCount + 1);
      break;
    }
  }
  
  // 无匹配则新增行
  if (!matchFound) {
    const newRowIndex = data1.length + 1;
    let countValue = 0;
    // 根据日期区间设置初始值
    const dateRanges = [
      {start: new Date("2023-01-01T00:00:00.000Z"), end: new Date("2023-01-04T17:30:00.000Z"), val: 1},
      {start: new Date("2023-01-04T17:30:01.000Z"), end: new Date("2023-01-11T17:30:00.000Z"), val: 2},
      {start: new Date("2023-01-11T17:30:01.000Z"), end: new Date("2023-01-18T17:30:00.000Z"), val: 3}
    ];
    for (const range of dateRanges) {
      if (updatedDate >= range.start && updatedDate <= range.end) {
        countValue = range.val;
        break;
      }
    }
    // 批量写入新行数据
    sheet1.getRange(newRowIndex, 1, 1, 2).setValues([[updatedValue, countValue]]);
  }
}

// 可安装onChange触发器的处理函数
function handleSheetChange(e) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  // 仅处理Sheet2的编辑或新增行事件
  if ((e.changeType === "EDIT" || e.changeType === "INSERT_ROW") && e.source.getSheetByName("Sheet2")) {
    const sheet2 = ss.getSheetByName("Sheet2");
    // 获取最后修改/新增的行（适配Zapier的更新逻辑）
    const lastRow = sheet2.getLastRow();
    incrementNumber(sheet2, lastRow);
  }
}

2. 创建可安装onChange触发器

1. 打开Google Sheets，点击「扩展程序」→「Apps Script」进入脚本编辑器。
2. 左侧菜单点击「触发器」图标（闹钟形状）。
3. 点击「添加触发器」：
   • 选择运行函数：handleSheetChange
   • 事件源：「电子表格」
   • 事件类型：「更改」
   • 保存并授权脚本权限（需用Google账号完成授权）。

3. 验证效果

通过Zapier更新Sheet2后，等待几秒检查Sheet1是否自动更新。若仍有问题，可查看脚本编辑器的「执行记录」（左侧菜单）排查报错。

额外优化建议 #

• 避免在循环中多次调用getRange和setValue，改用批量读写（如getDataRange().getValues()和setValues()）提升运行速度。
• 若Zapier是批量添加行，可修改handleSheetChange函数，处理新增的多行数据，而非仅最后一行。

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