为何Google Apps Script执行耗时过长 复制工作表无法保留权限

原脚本出现超时、权限不复制的问题来自两个核心缺陷：

• 超时原因：调用Sheets.Spreadsheets.get()时未指定字段拉取范围，接口默认返回整个电子表格的全量配置（包含所有工作表的单元格数据、格式、权限、元数据等）。当表格体量增大后，接口响应体积会暴涨，解析+传输的耗时很容易触发Apps Script的执行时间上限。
• 权限失效原因：原脚本仅删除了protectedRangeId字段，没有清理接口返回的其他只读属性（比如requestingUserCanEdit、editors.kind等），这些字段传入batchUpdate接口时会触发参数校验失败，导致保护规则创建请求被静默丢弃；另外原逻辑没有适配整表保护的场景，遇到整表保护规则时会直接因为range参数缺失报错。

优化后脚本将接口拉取范围缩小到仅需要的模板表保护配置字段，同时补全了参数清理逻辑，正常场景执行耗时不会超过10秒：

function duplicateSheetWithProtections() {
  const sheetNames = ["9 June", "10 June", "11 June"];
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const spreadsheetId = ss.getId();
  const templateSheet = ss.getSheetByName('Template');

  // 仅拉取模板表的保护规则字段，丢弃所有冗余数据，大幅降低接口耗时
  const spreadsheetData = Sheets.Spreadsheets.get(
    spreadsheetId,
    {
      ranges: ["'Template'!A:Z"],
      fields: "sheets.protectedRanges"
    }
  );
  const protectedRanges = spreadsheetData.sheets[0].protectedRanges || [];

  // 批量复制模板工作表
  const copiedSheetIds = sheetNames.map(name => {
    return templateSheet.copyTo(ss).setName(name).getSheetId();
  });

  // 构造批量请求，清理所有只读参数避免接口校验失败
  const requests = [];
  copiedSheetIds.forEach(newSheetId => {
    protectedRanges.forEach(originProtect => {
      const newProtect = JSON.parse(JSON.stringify(originProtect));
      // 移除所有接口自动生成的只读属性
      delete newProtect.protectedRangeId;
      delete newProtect.requestingUserCanEdit;

      // 适配整表保护、范围保护两种场景
      if (newProtect.range) {
        newProtect.range.sheetId = newSheetId;
      } else {
        newProtect.range = { sheetId: newSheetId };
      }

      // 仅警告类保护不需要携带编辑者列表，非警告类清理编辑者的只读属性
      if (newProtect.warningOnly) {
        delete newProtect.editors;
      } else if (newProtect.editors) {
        delete newProtect.editors.kind;
      }

      requests.push({
        addProtectedRange: { protectedRange: newProtect }
      });
    });
  });

  // 批量提交所有保护规则
  if (requests.length) {
    Sheets.Spreadsheets.batchUpdate({ requests }, spreadsheetId);
  }
}

• 运行脚本前需要确保已经在Apps Script编辑器的「服务」板块添加了Google Sheets API，否则会报接口不存在的错误
• 如果模板表的保护规则包含域级别的编辑权限，需要确保脚本运行账号有对应域的管理权限，否则这类规则会创建失败
• 如果需要复制的工作表数量超过10个，可以把batchUpdate的请求按50个一组拆分提交，避免单次请求体过大

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