如何获取Google Sheets onChange事件触发时的实际变更内容

解决方案1：快照对比法（适配onChange触发场景） #

onChange 事件本身确实不会返回具体变更内容，你可以通过存储历史快照对比的方式获取变更：

1. 先运行一次初始化函数，把当前要监控的表格数据存到脚本属性中作为初始快照：

// 初始化快照，仅需手动运行一次
function initSnapshot() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("你要监控的表名");
  const data = sheet.getDataRange().getValues();
  PropertiesService.getScriptProperties().setProperty("sheetSnapshot", JSON.stringify(data));
}

2. 改写你的onChange函数，每次触发时拉取当前数据和快照对比，提取变更内容：

function onChange(e) {
  // 只处理数据变更类事件，可根据需要调整监听的changeType
  const validTypes = ["EDIT", "INSERT_ROW", "DELETE_ROW", "INSERT_COLUMN", "DELETE_COLUMN"];
  if (!validTypes.includes(e.changeType)) return;

  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("你要监控的表名");
  const currentData = sheet.getDataRange().getValues();
  const snapshot = JSON.parse(PropertiesService.getScriptProperties().getProperty("sheetSnapshot") || "[]");
  
  // 对比数据找差异
  const changes = [];
  const maxRows = Math.max(currentData.length, snapshot.length);
  const maxCols = Math.max(currentData[0]?.length || 0, snapshot[0]?.length || 0);

  for (let i = 0; i < maxRows; i++) {
    for (let j = 0; j < maxCols; j++) {
      const oldVal = snapshot[i]?.[j] || "";
      const newVal = currentData[i]?.[j] || "";
      if (oldVal !== newVal) {
        changes.push({
          row: i + 1,
          column: j + 1,
          oldValue: oldVal,
          newValue: newVal
        });
      }
    }
  }

  // 此处可添加你对变更内容的处理逻辑
  console.log("检测到变更：", changes);

  // 更新快照
  PropertiesService.getScriptProperties().setProperty("sheetSnapshot", JSON.stringify(currentData));
}

解决方案2：Web App中转法（更稳定，适配外部POST场景） #

因为你的数据来自外部脚本POST请求，完全可以绕过表格自带的触发事件限制，直接用Apps Script写Web App接收POST请求：

1. 编写doPost函数接收外部数据，处理完后直接写入表格，不需要再监听变更：

function doPost(e) {
  try {
    const postData = JSON.parse(e.postData.contents);
    const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("目标表名");
    // 直接把接收到的数据写入表格，此处可根据你的数据结构调整写入逻辑
    sheet.appendRow(postData);
    // 你需要的其他处理逻辑直接在这里写即可
    return ContentService.createTextOutput(JSON.stringify({status: "success"})).setMimeType(ContentService.MimeType.JSON);
  } catch (err) {
    return ContentService.createTextOutput(JSON.stringify({status: "error", msg: err.message})).setMimeType(ContentService.MimeType.JSON);
  }
}

2. 把脚本部署为Web App，权限设置为「任何人，甚至匿名用户」可访问，把部署后的Web App URL替换你原来POST的表格地址即可。

注意事项 #

• 快照对比法如果数据量很大（超过10万单元格）会有性能损耗，建议只监控必要的行/列范围
• Web App中转法不会出现事件漏触发的情况，是外部数据写入场景的最优解

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