Google Sheets脚本替换受保护范围编辑者的代码逻辑报错问题

• 嵌套数组导致方法调用报错：Protections[p].getEditors()本身返回的是单维用户对象数组，原代码在返回值外额外套了一层方括号，生成了嵌套数组，后续遍历拿到的元素是整组用户对象而非单个用户，调用.getEmail()时会触发类型错误，这就是读取邮箱信息报错的核心原因。
• 未定义变量导致匹配逻辑失效：代码判断条件用的Protection_Idontknow从未被赋值定义，既不是用户邮箱也不是用户对象，匹配逻辑永远无法触发。
• 权限方法调用格式错误：Google Apps Script中Protection对象的addEditor()、removeEditor()是可执行方法，不是可直接赋值的属性，原代码的赋值写法完全不会生效。
• 邮箱提取的冗余嵌套：原代码提取邮箱时又在返回值外套了一层数组，拿到的是嵌套的邮箱数组而非字符串格式的邮箱，无法和字符串存储的Editor2Replace做等值匹配。

function syncProtectedEditor(sheet, Editor2Replace, Editor2Add) {
  const rangeProtections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE);
  
  for (let p = 0; p < rangeProtections.length; p++) {
    const protectionItem = rangeProtections[p];
    const editorList = protectionItem.getEditors();
    let needUpdate = false;

    // 遍历当前保护范围的所有编辑者
    for (let r = 0; r < editorList.length; r++) {
      const editorEmail = editorList[r].getEmail();
      // 统一转小写匹配，规避邮箱大小写不一致的漏判
      if (editorEmail.toLowerCase() === Editor2Replace.toLowerCase()) {
        needUpdate = true;
        break;
      }
    }

    // 匹配到待替换编辑者时再执行权限变更，避免重复操作
    if (needUpdate) {
      protectionItem.removeEditor(Editor2Replace);
      protectionItem.addEditor(Editor2Add);

      // 同步更新对应保护范围首行的E、F列编辑者记录
      const rangeStartRow = protectionItem.getRange().getRow();
      const colEValue = sheet.getRange(rangeStartRow, 5).getValue();
      const colFValue = sheet.getRange(rangeStartRow, 6).getValue();
      
      if (colEValue === Editor2Replace) {
        sheet.getRange(rangeStartRow, 5).setValue(Editor2Add);
      }
      if (colFValue === Editor2Replace) {
        sheet.getRange(rangeStartRow, 6).setValue(Editor2Add);
      }
    }
  }
}

• 处理权限时要跳过表格所有者账号，尝试移除所有者编辑权限会触发系统报错。
• 邮箱匹配统一转小写处理，因为Google账号邮箱本身不区分大小写，可避免人工输入大小写差异导致的匹配失败。
• 匹配到待替换账号后及时跳出当前保护范围的编辑者遍历，无需重复检查同范围下的其他编辑者，减少不必要的接口调用。

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