运行删除未使用筛选视图的Google Script时遇请求错误

问题根源 #

报错GoogleJsonResponseException: API call to sheets.spreadsheets.batchUpdate failed with error: Must specify at least one request的核心原因是：当没有找到名称匹配Filter [0-9]的筛选视图时，filterArr会是空数组，此时调用batchUpdate传入空请求数组，触发了API的必填校验规则。此外原脚本还存在误操作第一个工作表、API参数名错误的隐藏问题。

修改后的可用脚本 #

function delUnusedFilterViews() {
  var ssId = SpreadsheetApp.getActive().getId();
  var sheetName = SpreadsheetApp.getActiveSheet().getName();
  SpreadsheetApp.getActiveSpreadsheet().toast('Removing unnamed Filters from sheet: ' + sheetName);
  
  // 精准匹配当前活跃工作表，避免误操作其他表
  var targetSheet = Sheets.Spreadsheets.get(ssId).sheets.find(sheet => sheet.properties.title === sheetName);
  if (!targetSheet || !targetSheet.filterViews) {
    Browser.msgBox("当前工作表无筛选视图，无需操作");
    return;
  }
  
  var allFilters = targetSheet.filterViews;
  var filterArr = [];
  for (var i in allFilters) {
    var currFilter = allFilters[i];
    var filterName = currFilter.title;
    var currFilterId = currFilter.filterViewId;
    // 匹配默认命名的筛选视图
    if (/Filter [0-9]/.test(filterName)) {
      // 修正API参数名：filterId → filterViewId
      filterArr.push({ deleteFilterView: { filterViewId: currFilterId } });
    }
  }
  
  // 仅当存在待删除视图时才调用API
  if (filterArr.length > 0) {
    Sheets.Spreadsheets.batchUpdate({
      requests: filterArr
    }, ssId);
    Browser.msgBox("操作完成，刷新工作表即可看到筛选视图已删除");
  } else {
    Browser.msgBox("未找到需要删除的筛选视图");
  }
}

关键优化点 #

• 精准定位工作表：原脚本直接取sheets[0]会误操作第一个工作表，改为通过名称匹配当前活跃工作表。
• 空值前置校验：提前判断工作表是否存在筛选视图，避免读取undefined属性引发报错。
• 避免空请求：调用batchUpdate前检查待删除视图数组长度，空数组时跳过API调用。
• 修正API参数：原脚本使用错误参数名filterId，改为Sheets API要求的filterViewId，确保删除操作生效。

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