如何使用 Google Apps Script 批量删除所有工作表中的列组内列-js教程-PHP中文网

如何使用 Google Apps Script 批量删除所有工作表中的列组内列

本文介绍两种高效方法：一种纯 apps script 实现，通过反向遍历逐列检测并删除属于列组的列；另一种借助 sheets api 批量操作，显著提升大型表格处理性能，并附关键注意事项与完整可运行代码。

本文介绍两种高效方法：一种纯 apps script 实现，通过反向遍历逐列检测并删除属于列组的列；另一种借助 sheets api 批量操作，显著提升大型表格处理性能，并附关键注意事项与完整可运行代码。

在 Google Sheets 中，列组（Column Groups）常用于折叠/展开数据区域，但有时需彻底清理其内部列（例如重构报表结构或自动化模板重置）。由于列组位置动态且无直接 API 获取全部范围，不能依赖固定区间操作。以下提供两种生产级解决方案，兼顾易用性与性能。

✅ 方法一：纯 Apps Script（推荐入门使用）

该方案无需启用高级服务，逻辑清晰、易于调试。核心思路是：从右向左遍历每张表的所有列（1 到最大列数），利用 getColumnGroupDepth(columnIndex) 判断该列是否属于任意层级的列组（深度 > 0），若是则调用 deleteColumn() 删除。注意必须倒序遍历——否则删除左侧列会导致右侧列索引偏移，遗漏目标列。

function deleteColumnsInsideColumnGroups() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.getSheets().forEach(sheet => {
    const maxCol = sheet.getMaxColumns(); // 获取当前表最大列数（含隐藏列）
    // 从最后一列开始反向遍历，避免索引错位
    for (let col = maxCol; col >= 1; col--) {
      if (sheet.getColumnGroupDepth(col) > 0) {
        sheet.deleteColumn(col);
      }
    }
  });
  console.log("✅ 所有工作表中的列组内列已删除。");
}

⚠️ 注意事项：

getMaxColumns() 返回的是工作表理论最大列数（通常为 26 * 26 = 676），实际有效列可能更少。若数据稀疏，可先用 sheet.getLastColumn() 获取末尾非空列优化性能，但列组可能存在于空白区域，故仍建议使用 getMaxColumns() 确保全覆盖。

此方法对每列单独调用 deleteColumn()，在列组数量极大时（如数百列）可能触发执行时间限制（默认 6 分钟）。此时推荐方法二。

⚡ 方法二：Sheets API 批量操作（高性能首选）

针对大型表格或频繁调用场景，使用 Sheets API 的 batchUpdate 可一次性提交所有删除请求，避免多次服务端往返，大幅提升效率。需提前在脚本编辑器中启用 Sheets API（菜单栏：Resources → Advanced Google services → 开启 Google Sheets API）。

SerpApi Flights (Google Flights)

通过 SerpApi 查询 Google Flights，获取航班时刻表、价格及舱位等级信息。当用户询问航班 / 机票 / 航班价格、时刻表或对比信息时使用。

下载

function deleteColumnsInsideColumnGroupsAPI() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const ssId = ss.getId();

  // 获取所有工作表的列组元数据（仅请求 columnGroups 字段，轻量高效）
  const { sheets } = Sheets.Spreadsheets.get(ssId, { 
    fields: "sheets(columnGroups,properties.sheetId)" 
  });

  const requests = [];

  sheets.forEach(sheet => {
    const sheetId = sheet.properties?.sheetId;
    if (!sheetId || !sheet.columnGroups) return;

    // 筛选深度为 1 的列组（顶层组，避免重复删除嵌套组内列）
    sheet.columnGroups
      .filter(group => group.depth === 1)
      .forEach(group => {
        requests.push({
          deleteDimension: {
            range: {
              sheetId: sheetId,
              dimension: "COLUMNS",
              startIndex: group.startColumn,
              endIndex: group.endColumn + 1 // endIndex 是开区间，+1 匹配 Sheets API 范围定义
            }
          }
        });
      });
  });

  if (requests.length === 0) {
    console.log("ℹ️ 未发现任何列组，无需操作。");
    return;
  }

  // 批量执行删除（自动按 sheetId 分组，安全高效）
  Sheets.Spreadsheets.batchUpdate({ requests }, ssId);
  console.log(`✅ 已批量删除 ${requests.length} 个列组内的列。`);
}

? 关键说明：

depth === 1 确保只处理顶层列组，防止嵌套组被重复计算（例如 [A:C] 内嵌 [B:B]，删除 A:C 即覆盖全部）。

endIndex 在 Sheets API 中为开区间（[startIndex, endIndex)），因此需 group.endColumn + 1。

batchUpdate 自动按 sheetId 分组执行，无需手动拆分请求。