如何通过Google Sheets API仅在表格变更时导入数据（JavaScript）

Google Sheets没有原生提供变更通知的Webhook，但可以通过以下几种可行方案实现“仅在数据变更时执行脚本”的需求：

1. 用Google Apps Script实现变更触发推送 #

这是最直接且易实现的方案，通过绑定在表格上的脚本触发器，在数据变更时主动通知你的前端/后端。

• 核心逻辑：使用onChange()触发器（覆盖编辑、行增减、格式变更等多种事件）或onEdit()触发器（仅手动单元格编辑触发），在事件触发时调用你的接收端点，通知数据已变更。
• 示例代码（Google Apps Script）：

  function onChange(e) {
    // 过滤仅关注数据相关的变更事件
    const targetChanges = ['EDIT', 'INSERT_ROW', 'DELETE_ROW', 'INSERT_COLUMN', 'DELETE_COLUMN'];
    if (targetChanges.includes(e.changeType)) {
      // 发送通知到你的接收URL（比如前端的WebSocket端点或后端接口）
      const payload = {
        sheetId: SpreadsheetApp.getActiveSpreadsheet().getId(),
        changeType: e.changeType
      };
      UrlFetchApp.fetch('你的接收通知地址', {
        method: 'POST',
        contentType: 'application/json',
        payload: JSON.stringify(payload),
        muteHttpExceptions: true // 避免因请求失败导致触发器报错
      });
    }
  }
  

• 设置步骤：
  • 打开目标Google表格，点击「扩展程序」→「Apps 脚本」
  • 粘贴上述代码，替换接收URL
  • 在脚本编辑器中，点击「编辑」→「当前项目的触发器」，添加新触发器：选择onChange函数，事件类型选「从电子表格提交」→「变更」
  • 完成授权（需允许脚本访问表格和发送网络请求）

2. 利用Google Drive变更API监听文件更新 #

由于Google Sheets文件存储在Google Drive中，可以通过Drive API的变更订阅功能监听文件修改事件。

• 核心逻辑：调用Drive API的changes.watch方法，订阅目标表格文件的变更。当文件（包括表格内容）被修改时，Google会向你指定的端点发送HTTP通知。
• 注意事项：
  • 需要验证订阅端点的合法性（Google会发送验证请求，需正确响应）
  • 收到通知后，需解析事件内容，确认是表格内容变更而非文件名、权限等其他属性变更
  • 订阅有有效期，需要定期续期

3. 优化轮询策略（低成本过渡方案） #

如果暂时不想引入新的服务或脚本，可以优化现有轮询逻辑，减少不必要的请求：

• 每次请求先获取表格的modifiedTime（通过Sheets API的spreadsheets.get接口），对比上次记录的时间，仅当时间更新时才获取数据。
• 示例修改你的现有脚本：

  // 全局变量保存上次修改时间
  let lastModifiedTime = '';
  
  async function fetchSheetData() {
    const base = `https://sheets.googleapis.com/v4/spreadsheets/${ID}`;
    // 1. 获取表格修改时间
    const metaRes = await fetch(`${base}?key=${API_KEY}&fields=modifiedTime`);
    const { modifiedTime } = await metaRes.json();
    
    if (modifiedTime === lastModifiedTime) {
      console.log('数据未变更，跳过获取');
      return;
    }
  
    // 2. 执行原有的数据获取逻辑
    const res1 = await fetch(`${base}?key=${API_KEY}&fields=namedRanges(name)`);
    const { namedRanges } = await res1.json();
    
    const ranges = namedRanges.map(({ name }) => `ranges=${encodeURIComponent(name)}`).join('&');
    const res2 = await fetch(`${base}/values:batchGet?key=${API_KEY}&${ranges}`);
    const { valueRanges } = await res2.json();
    
    const res = valueRanges.reduce((o, { values }, i) => (o[namedRanges[i].name] = values, o), {});
    console.log(res);
  
    // 更新上次修改时间
    lastModifiedTime = modifiedTime;
  }
  
  // 改为5分钟轮询一次（可根据需求调整）
  setInterval(fetchSheetData, 5 * 60 * 1000);
  

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