Google App Script中setUnprotectedRanges报错：参数(number[])不匹配方法签名

问题描述 #

我有一个受保护的Google表格，通过部署为Web App的脚本复制粘贴包含未保护单元格的行，期望粘贴后的行保留相同的未保护单元格。具体做法是：获取表格所有未保护范围，遍历数组，若未保护范围属于模板行，则添加粘贴后对应位置的新范围到数组。但调用protection.setUnprotectedRanges时出现错误：

Exception: The parameters (number[]) don't match the method signature for SpreadsheetApp.Protection.setUnprotectedRanges

无法理解为何接收Range数组的方法会报错，寻求帮助。

解决方案 #

• 错误核心：你传入setUnprotectedRanges的数组里混入了数字类型元素，而非纯Range对象，导致方法签名不匹配。
• 排查重点：检查遍历未保护范围、创建新范围的代码段，确认添加到新数组的每一项都是通过getRange()类方法生成的Range实例，而非行号、列号这类数字值。
• 修正示例代码（假设模板行是第2行）：

function copyRowWithUnprotectedRanges() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  const templateRow = 2;
  const newRow = sheet.getLastRow() + 1;
  
  // 复制模板行到新行
  sheet.getRange(templateRow, 1, 1, sheet.getLastColumn())
       .copyTo(sheet.getRange(newRow, 1, 1, sheet.getLastColumn()), SpreadsheetApp.CopyPasteType.PASTE_ALL);
  
  // 获取工作表保护规则
  const protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0];
  if (!protection) return;
  
  // 整理新的未保护范围数组
  const originalUnprotected = protection.getUnprotectedRanges();
  const newUnprotected = [];
  
  originalUnprotected.forEach(range => {
    if (range.getRow() === templateRow) {
      // 生成新行对应的Range对象，确保是Range实例
      const newRange = sheet.getRange(newRow, range.getColumn(), 1, range.getNumColumns());
      newUnprotected.push(newRange);
    } else {
      // 保留非模板行的原有未保护范围
      newUnprotected.push(range);
    }
  });
  
  // 设置新的未保护范围
  protection.setUnprotectedRanges(newUnprotected);
}

• 关键注意事项：
  • 始终确保newUnprotected数组中的元素都是Range对象，避免误插入行号、列号等数字。
  • 检查遍历逻辑，确认没有将range.getRow()/range.getColumn()这类返回值直接推入数组。

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