请求优化Google Apps Script批量保护表格行的性能

之前的函数因逐行添加保护项，数据量大时会因多次调用保护API导致性能瓶颈。下面是优化后的实现，核心思路是先筛选所有符合条件的行，再将连续行合并为单个范围，最后批量创建保护项，大幅减少保护条目数量并提升运行速度。

优化后代码 #

function ProtectEntradas() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Entradas"); // 替换为你的目标表名
  const dataRange = sheet.getDataRange();
  const values = dataRange.getValues();
  const today = new Date();
  const protectRows = [];

  // 筛选符合条件的行（假设表头在第1行，跳过表头）
  for (let i = 1; i < values.length; i++) {
    const rowDate = values[i][0]; // 假设日期在A列，根据实际调整列索引
    const qColumnValue = values[i][16]; // Q列为第17列，对应数组索引16
    // 判定条件：日期小于今日 且 Q列不为空
    if (rowDate instanceof Date && rowDate < today && qColumnValue !== "") {
      protectRows.push(i + 1); // 转换为表格实际行号（数组索引从0开始，行号从1开始）
    }
  }

  // 合并连续行号为可批量保护的范围
  const rangesToProtect = [];
  if (protectRows.length === 0) return; // 无符合条件的行，直接退出

  let startRow = protectRows[0];
  let endRow = startRow;

  for (let i = 1; i < protectRows.length; i++) {
    if (protectRows[i] === endRow + 1) {
      endRow = protectRows[i];
    } else {
      rangesToProtect.push(sheet.getRange(startRow, 1, endRow - startRow + 1, sheet.getLastColumn()));
      startRow = protectRows[i];
      endRow = startRow;
    }
  }
  // 添加最后一组连续行范围
  rangesToProtect.push(sheet.getRange(startRow, 1, endRow - startRow + 1, sheet.getLastColumn()));

  // 批量创建保护并设置权限
  const currentUser = Session.getEffectiveUser();
  rangesToProtect.forEach(range => {
    const protection = range.protect().setDescription("Auto-protected by script");
    // 移除所有默认编辑者，仅保留当前用户
    const editors = protection.getEditors();
    protection.removeEditors(editors);
    if (!protection.canEdit()) {
      protection.addEditor(currentUser);
    }
  });

  SpreadsheetApp.getUi().alert(`保护完成，共创建 ${rangesToProtect.length} 个保护范围`);
}

关键优化点说明 #

• 内存内筛选：一次性读取全表数据，在内存中完成条件判断，减少表格读写次数
• 连续行合并：将连续的符合条件行合并为单个范围，避免逐行创建保护项，大幅降低API调用频次
• 批量权限设置：对合并后的范围统一配置保护权限，提升执行效率

注意事项 #

• 根据实际表格结构，调整日期列、Q列的数组索引（代码中默认日期在A列、Q列为第17列）
• 若表头不在第1行，需修改循环起始的i值
• 保护权限逻辑可按需调整（比如保留特定团队成员的编辑权限等）

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