如何加速Google Apps Script中getRowHeight与getColumnWidth调用速度？

核心原因 #

getRowHeight()和getColumnWidth()属于SpreadsheetApp的单次请求方法，每次调用都会单独与Google Sheets服务器建立交互。在包含多工作表、大体积数据的表格中，服务器响应延迟叠加，导致单调用耗时5-10秒，循环调用完全无法高效完成。

最优解决方案：使用Google Sheets Advanced Service批量获取 #

通过Sheets Advanced Service的spreadsheets.get接口，可一次性获取指定工作表的所有行高/列宽元数据，仅需一次API调用，效率提升显著。

步骤1：启用Sheets Advanced Service

在脚本编辑器中：

• 点击菜单栏「资源」→「高级Google服务」
• 找到「Google Sheets API」，开启开关并保存

批量获取行高示例代码

function calculateTotalRowHeight() {
  const sheetName = "你的工作表名称"; // 替换为目标工作表名
  const startRow = 10; // 起始行
  const endRow = 29; // 结束行（对应原循环的row < 30）
  
  const ss = SpreadsheetApp.getActive();
  const response = Sheets.Spreadsheets.get(ss.getId(), {
    ranges: sheetName,
    fields: "sheets(data(rowMetadata(height)))" // 仅请求行高元数据，减少传输量
  });

  // 提取所有行高，未自定义的行使用默认高度21像素
  const allRowHeights = response.sheets[0].data[0].rowMetadata.map(row => row.height || 21);
  
  // 计算指定区间的行高总和
  const targetHeights = allRowHeights.slice(startRow - 1, endRow); // 数组索引从0开始
  const totalHeight = targetHeights.reduce((sum, height) => sum + height, 0);
  
  Logger.log(`第${startRow}-${endRow}行高度总和：${totalHeight}`);
}

批量获取列宽示例代码

function calculateTotalColumnWidth() {
  const sheetName = "你的工作表名称";
  const startCol = 1; // 起始列
  const endCol = 10; // 结束列
  
  const ss = SpreadsheetApp.getActive();
  const response = Sheets.Spreadsheets.get(ss.getId(), {
    ranges: sheetName,
    fields: "sheets(data(columnMetadata(width)))" // 仅请求列宽元数据
  });

  // 提取所有列宽，未自定义的列使用默认宽度100像素
  const allColumnWidths = response.sheets[0].data[0].columnMetadata.map(col => col.width || 100);
  
  // 计算指定区间的列宽总和
  const targetWidths = allColumnWidths.slice(startCol - 1, endCol);
  const totalWidth = targetWidths.reduce((sum, width) => sum + width, 0);
  
  Logger.log(`第${startCol}-${endCol}列宽度总和：${totalWidth}`);
}

替代优化方案（无法使用Advanced Service时） #

如果因权限或环境限制无法启用Advanced Service，可尝试以下优化：

• 减少调用次数：避免在循环中逐行/列调用，若需多次查询相同行/列的高度，可将结果存入CacheService缓存，后续直接读取缓存值
• 限定操作范围：仅针对需要统计的行/列进行操作，避免无关的工作表或数据干扰

效果对比 #

• 原循环方式：20行耗时约1分钟
• Advanced Service批量方式：数百行仅需数秒即可完成

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