Google APIs是否有等效于MS Excel VBA Worksheet.UsedRange的调用？

Excel VBA 的 Worksheet.UsedRange 会返回工作表中包含数据、格式或其他非默认属性的最小单元格区域，在 Google Sheets 生态中，可通过以下两种方式实现近似或完全等效的功能：

1. Google Sheets API（REST）实现 #

通过 spreadsheets.get 接口获取工作表的网格数据后，自行分析出目标区域：

请求示例 #

调用接口时需指定 includeGridData=true 以获取单元格的内容和格式信息，同时定位目标工作表：

GET https://sheets.googleapis.com/v4/spreadsheets/{SPREADSHEET_ID}?includeGridData=true&ranges=List1

响应处理逻辑 #

从返回的响应体中提取 sheets[].data[].rowData 和 sheets[].data[].columnMetadata，执行以下判断：

• 遍历所有行，标记最后一行包含非空单元格或自定义格式的行号
• 遍历所有列，标记最后一列包含非空单元格或自定义格式的列号
• 组合起始行（默认1）、起始列（默认1）、结束行、结束列，得到等效的 UsedRange 范围

2. Google Apps Script 实现 #

如果使用类 VBA 的脚本环境，可直接调用内置方法或自定义逻辑：

近似等效：getDataRange() #

getDataRange() 会返回包含所有数据的最小单元格范围，是日常场景中最接近 UsedRange 的快捷方法：

function getUsedRangeEquivalent() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("List1");
  const usedRange = sheet.getDataRange();
  
  // 获取范围的边界信息
  const startRow = usedRange.getRow();
  const startCol = usedRange.getColumn();
  const lastRow = usedRange.getLastRow();
  const lastCol = usedRange.getLastColumn();
  
  console.log(`等效区域：${String.fromCharCode(64 + startCol)}${startRow}:${String.fromCharCode(64 + lastCol)}${lastRow}`);
}

完全等效（含格式单元格） #

若需完全匹配 UsedRange（包含仅设置格式的空单元格），需遍历单元格检查格式属性：

function getFullUsedRange() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("List1");
  const maxRows = sheet.getMaxRows();
  const maxCols = sheet.getMaxColumns();
  
  let lastUsedRow = 0;
  let lastUsedCol = 0;
  
  // 检查每一行是否有数据或自定义格式
  for (let row = 1; row <= maxRows; row++) {
    const rowRange = sheet.getRange(row, 1, 1, maxCols);
    const cellValues = rowRange.getValues()[0];
    const cellBackgrounds = rowRange.getBackgrounds()[0];
    
    const hasContentOrFormat = cellValues.some(cell => cell !== "") 
      || cellBackgrounds.some(color => color !== "#ffffff");
    
    if (hasContentOrFormat) lastUsedRow = row;
  }
  
  // 检查每一列是否有数据或自定义格式
  for (let col = 1; col <= maxCols; col++) {
    const colRange = sheet.getRange(1, col, maxRows, 1);
    const cellValues = colRange.getValues().map(row => row[0]);
    const cellBackgrounds = colRange.getBackgrounds().map(row => row[0]);
    
    const hasContentOrFormat = cellValues.some(cell => cell !== "") 
      || cellBackgrounds.some(color => color !== "#ffffff");
    
    if (hasContentOrFormat) lastUsedCol = col;
  }
  
  if (!lastUsedRow || !lastUsedCol) {
    console.log("工作表无已使用区域");
    return;
  }
  
  const fullUsedRange = sheet.getRange(1, 1, lastUsedRow, lastUsedCol);
  console.log(`完全等效区域：A1:${String.fromCharCode(64 + lastUsedCol)}${lastUsedRow}`);
}

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