Google Sheets脚本：引用列存储的文档ID批量执行多表更新

前置准备 #

• 新建1份独立的Google Sheets作为主控表，专门存储所有待更新文档的ID
• 在主控表任意工作表（默认的Sheet1即可）的A列，A1单元格填表头「目标文档ID」，从A2开始逐行填入70份待更新表格的ID（表格ID是表格URL中/d/和/edit之间的字符串）
• 确认当前账号对主控表、所有70份待更新表格都拥有编辑权限，避免运行时报权限错误

改造后完整脚本 #

脚本保留了你原有单文档更新的全部核心逻辑，新增了批量读取ID、遍历执行、错误捕获能力，适合初学者直接修改配置使用：

// -------------------------- 只需要修改这部分配置即可 --------------------------
const MASTER_SPREADSHEET_ID = "替换为你的主控表ID"; // 主控表的ID
const ID_SHEET_NAME = "Sheet1"; // 存放文档ID的工作表名称
const ID_COLUMN_INDEX = 1; // 文档ID存放在第几列，A列=1、B列=2，以此类推
const ID_START_ROW = 2; // 文档ID从第几行开始，默认第1行是表头，所以从第2行读
const TARGET_SHEET_NAME = "Role 1"; // 待更新的工作表名
const INSERT_ROW_POSITION = 19; // 在第几行前插入新行
// -----------------------------------------------------------------------------

function batchUpdateAllSheets() {
  // 读取主控表中所有有效的目标文档ID
  const masterSs = SpreadsheetApp.openById(MASTER_SPREADSHEET_ID);
  const idSheet = masterSs.getSheetByName(ID_SHEET_NAME);
  const lastRow = idSheet.getLastRow();
  // 读取ID列从起始行到最后一行的所有值，过滤空单元格
  const allIdValues = idSheet
    .getRange(ID_START_ROW, ID_COLUMN_INDEX, lastRow - ID_START_ROW + 1, 1)
    .getValues()
    .flat()
    .filter(id => id.toString().trim());

  // 提前计算次日日期，所有文档共用，不用重复计算提升效率
  const now = new Date();
  const dd = String(now.getDate() + 1).padStart(2, '0');
  const mm = String(now.getMonth() + 1).padStart(2, '0');
  const yyyy = now.getFullYear();
  const fillDate = `${mm}/${dd}/${yyyy}`;

  // 遍历所有文档ID逐个执行更新
  allIdValues.forEach((docId, seq) => {
    try {
      // 原有单文档更新逻辑
      const targetSs = SpreadsheetApp.openById(docId.toString().trim());
      const targetSheet = targetSs.getSheetByName(TARGET_SHEET_NAME);
      if (!targetSheet) throw new Error(`找不到名为${TARGET_SHEET_NAME}的工作表`);
      
      targetSheet.insertRowBefore(INSERT_ROW_POSITION);
      targetSheet.getRange(INSERT_ROW_POSITION, 1).setValue(fillDate);
      targetSheet.getRange(INSERT_ROW_POSITION, 8).setValue(fillDate);
      targetSheet.getRange(INSERT_ROW_POSITION, 13).setValue(fillDate);

      console.log(`第${seq + 1}份文档更新成功，文档ID：${docId}`);
    } catch (err) {
      // 单个文档更新失败不中断整个批量任务，打印失败原因方便排查
      console.error(`第${seq + 1}份文档更新失败，文档ID：${docId}，失败原因：${err.message}`);
    }
  })
}

关键逻辑说明 #

• 配置项全部抽离到脚本最开头，你不需要修改核心逻辑，只需要按自己的实际情况改配置值就行
• 读取ID时自动过滤空单元格，不会因为表格末尾有空行导致报错
• 把日期计算逻辑提到循环外，所有文档共用同一个计算结果，比原来每个文档重新算日期效率更高
• 加了异常捕获逻辑，某一份文档因为ID填错、权限不足、找不到指定工作表等原因更新失败时，不会中断整个批量任务，执行日志里会明确打印失败的文档和原因，方便后续排查
• 完全保留你原来的更新规则：在指定工作表的第19行前插入新行，将次日日期填入新行的第1、8、13列

使用步骤 #

1. 打开主控表，点击顶部菜单栏「扩展程序」->「Apps 脚本」，打开脚本编辑器
2. 删掉编辑器里默认的所有代码，粘贴上面的完整脚本
3. 修改脚本开头的配置项，把主控表ID等信息换成你自己的
4. 点击顶部的保存按钮，给脚本取个容易识别的名字，比如「每周批量更新报表」
5. 第一次运行时会弹出谷歌的授权提示，因为是你自己编写的私人脚本，遇到「应用未验证」提示时，点击「高级」->「继续前往（你的脚本名）」即可完成授权
6. 运行完成后，可以在脚本编辑器的「执行日志」面板查看所有文档的更新成功/失败记录
7. 如果需要每周自动执行，点击脚本编辑器左侧边栏的「触发器」按钮，添加新触发器：选择batchUpdateAllSheets函数，触发类型选「时间驱动」，频率选「周定时器」，设置你需要更新的星期和具体时间，保存后就会到点自动跑，不用手动操作

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