如何通过Google表格复选框动态管控编辑者的受保护单元格访问权限？

嗨，作为Google Apps Script新手，你想打造基于复选框的全局权限管控门户这个需求真的很实用！我来帮你梳理清楚思路，把你现有的代码整合优化成符合预期的方案~

你需要一个集中管控的工作表（咱们叫它「权限管控门户」），里面列好20位编辑者的信息，对应每个表格放一个复选框：

• 勾选复选框 → 给这位编辑者开通对应表格的编辑权限
• 取消复选框 → 收回该编辑者对应表格的权限
• 要覆盖10+表格的批量权限管理，不用逐个表格手动设置

先把你的管控表改成这个格式（表头要包含表格ID，方便脚本识别）：

注：表格ID从目标表格的URL里提取，比如https://docs.google.com/spreadsheets/d/xxx/edit里的xxx就是表格ID

下面是整合了你提供的两段代码逻辑，同时优化了权限操作的安全性和效率：

// 处理复选框触发的权限变更（必须用可安装触发，不能用简单onEdit）
function handlePermissionChange(e) {
  const controlSheetName = "权限管控门户"; // 替换成你的管控表名称
  const controlSheet = e.source.getSheetByName(controlSheetName);
  
  // 判断是否是管控表的复选框列（从第3列开始，前2列是邮箱和角色）
  if (!controlSheet || e.range.getSheet().getName() !== controlSheetName || e.range.columnStart < 3) {
    return;
  }

  const row = e.range.rowStart;
  const col = e.range.columnStart;
  const editorEmail = controlSheet.getRange(row, 1).getValue(); // 获取当前行的编辑者邮箱
  const sheetIdMatch = controlSheet.getRange(1, col).getValue().match(/ID:(.*)/); // 从表头提取表格ID
  
  // 校验必要信息
  if (!editorEmail || !sheetIdMatch) {
    console.log("缺少编辑者邮箱或表格ID，跳过操作");
    return;
  }

  const sheetId = sheetIdMatch[1];
  const isChecked = e.value === "TRUE";

  try {
    const targetSheet = SpreadsheetApp.openById(sheetId);
    const ownerEmail = targetSheet.getOwner().getEmail();
    const existingEditors = targetSheet.getEditors().map(editor => editor.getEmail());

    if (isChecked) {
      // 勾选时：如果还不是编辑者，添加权限
      if (!existingEditors.includes(editorEmail)) {
        targetSheet.addEditor(editorEmail);
        console.log(`已给${editorEmail}添加表格${sheetId}的编辑权限`);
      }
    } else {
      // 取消勾选时：如果是编辑者且不是所有者，移除权限
      if (existingEditors.includes(editorEmail) && editorEmail !== ownerEmail) {
        targetSheet.removeEditor(editorEmail);
        console.log(`已收回${editorEmail}对表格${sheetId}的编辑权限`);
      } else if (editorEmail === ownerEmail) {
        console.log(`无法移除所有者${editorEmail}的权限，操作跳过`);
      }
    }
  } catch (error) {
    console.error(`权限操作失败：${error.message}`);
    // 可选：这里可以加邮件通知逻辑，提醒管理员操作出错
  }
}

// 初始化所有表格权限（首次设置时用，批量同步复选框状态到所有表格）
function initPermissions() {
  const controlSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("权限管控门户");
  const lastRow = controlSheet.getLastRow();
  const lastCol = controlSheet.getLastColumn();

  // 先收集所有目标表格的ID
  const sheetIds = [];
  for (let col = 3; col <= lastCol; col++) {
    const idMatch = controlSheet.getRange(1, col).getValue().match(/ID:(.*)/);
    if (idMatch) sheetIds.push(idMatch[1]);
  }

  // 第一步：清空所有表格的非所有者编辑者（避免权限混乱）
  sheetIds.forEach(sheetId => {
    const targetSheet = SpreadsheetApp.openById(sheetId);
    const ownerEmail = targetSheet.getOwner().getEmail();
    targetSheet.getEditors().forEach(editor => {
      const editorEmail = editor.getEmail();
      if (editorEmail !== ownerEmail) {
        targetSheet.removeEditor(editorEmail);
      }
    });
  });

  // 第二步：根据复选框批量添加权限
  for (let row = 2; row <= lastRow; row++) {
    const editorEmail = controlSheet.getRange(row, 1).getValue();
    if (!editorEmail) continue;

    for (let col = 3; col <= lastCol; col++) {
      const isChecked = controlSheet.getRange(row, col).getValue();
      const idMatch = controlSheet.getRange(1, col).getValue().match(/ID:(.*)/);
      if (isChecked && idMatch) {
        const sheetId = idMatch[1];
        SpreadsheetApp.openById(sheetId).addEditor(editorEmail);
        console.log(`初始化：给${editorEmail}添加表格${sheetId}的权限`);
      }
    }
  }
}

• 触发方式调整：原来的onEdit是简单触发，没有跨表格修改权限的权限，必须改成可安装的编辑触发（步骤：脚本编辑器→「编辑」→「当前项目的触发器」→「添加触发器」，选择handlePermissionChange，事件源选「从电子表格」，事件类型选「编辑时」）
• 避免重复操作：每次操作前先检查编辑者是否已经在权限列表里，减少不必要的API调用
• 所有者保护：自动判断要移除的编辑者是不是表格所有者，防止误删导致权限失控
• 错误处理：添加try-catch捕获异常，方便通过日志排查问题

1. 按照上面的结构整理你的「权限管控门户」表格
2. 在脚本编辑器里粘贴上述代码，替换controlSheetName为你的管控表名称
3. 设置可安装触发器（按照上面的触发方式调整说明操作）
4. 首次运行initPermissions函数，同步所有表格的初始权限

• 可以给「角色」列添加筛选功能，后续扩展成按角色批量设置权限（比如给所有「运营」角色批量开通指定表格权限）
• 开启脚本日志功能（脚本编辑器→「查看」→「日志」），随时查看权限操作的执行情况
• 如果需要更精细的权限（比如仅查看权限），可以把addEditor改成addViewer，removeEditor改成removeViewer

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