如何通过Sheets API设置范围获取同一电子表格多工作表数据？

没问题！用Sheets API完全可以实现批量获取指定范围或全部工作表的数据，我给你拆解下具体步骤和代码示例：

首先得调用spreadsheets.get接口拿到所有工作表的ID、标题和位置索引——这一步是为了后续筛选范围或者遍历所有表，而且我们可以设置includeGridData: false，只拿元数据不拿内容，节省请求资源。

用Node.js的googleapis库的示例代码如下：

const { google } = require('googleapis');

// 假设你已经完成了OAuth2授权或服务账号授权，拿到了auth对象
const sheets = google.sheets({ version: 'v4', auth });

async function getAllSheets(spreadsheetId) {
  const response = await sheets.spreadsheets.get({
    spreadsheetId,
    includeGridData: false, // 仅获取工作表的基础信息，不返回单元格数据
  });
  // 整理出我们需要的字段：sheetId、标题、位置索引
  return response.data.sheets.map(sheet => ({
    sheetId: sheet.properties.sheetId,
    title: sheet.properties.title,
    index: sheet.properties.index // 工作表在表格里的位置，从0开始计数
  }));
}

如果你不需要全部工作表，只想获取从X到Y的范围（比如从标题为"Q1数据"到"Q4数据"，或者按位置索引筛选），可以在拿到所有工作表列表后做过滤：

按标题范围筛选 #

async function filterSheetsByTitleRange(spreadsheetId, startTitle, endTitle) {
  const allSheets = await getAllSheets(spreadsheetId);
  const startSheet = allSheets.find(sheet => sheet.title === startTitle);
  const endSheet = allSheets.find(sheet => sheet.title === endTitle);
  
  if (!startSheet || !endSheet) {
    throw new Error('指定的起始或结束工作表不存在，请检查标题拼写');
  }
  
  // 筛选出位置在起始和结束表之间的所有工作表
  return allSheets.filter(sheet => sheet.index >= startSheet.index && sheet.index <= endSheet.index);
}

按位置索引直接筛选 #

比如要获取第2到第5个工作表（索引从0开始，对应界面上的第3到第6个表）：

const allSheets = await getAllSheets('你的表格ID');
const targetSheets = allSheets.filter(sheet => sheet.index >= 1 && sheet.index <= 4);

接下来用spreadsheets.values.batchGet接口一次性获取多个工作表的数据——这个接口比逐个调用单表接口高效得多，支持同时传入多个范围参数。如果要获取整个工作表的所有数据，可以用工作表标题!A:XFD（XFD是Sheets的最大列数，确保覆盖所有内容）。

示例代码：

async function getBatchSheetData(spreadsheetId, targetSheets) {
  // 构造每个工作表的查询范围
  const ranges = targetSheets.map(sheet => `${sheet.title}!A:XFD`);
  
  const response = await sheets.spreadsheets.values.batchGet({
    spreadsheetId,
    ranges,
    // 可选：控制数据渲染格式，比如获取原始值还是格式化后的值
    valueRenderOption: 'UNFORMATTED_VALUE',
    dateTimeRenderOption: 'SERIAL_NUMBER'
  });
  
  // 把返回的数据和对应的工作表信息关联起来，方便后续处理
  return response.data.valueRanges.map((range, index) => ({
    sheetTitle: targetSheets[index].title,
    sheetId: targetSheets[index].sheetId,
    data: range.values || [] // 如果工作表为空，返回空数组避免报错
  }));
}

如果要获取全部工作表的数据，直接把上面的函数串起来就行：

async function fetchAllSheetData(spreadsheetId) {
  const allSheets = await getAllSheets(spreadsheetId);
  return getBatchSheetData(spreadsheetId, allSheets);
}

// 调用示例
const targetSpreadsheetId = '替换成你的电子表格ID';
fetchAllSheetData(targetSpreadsheetId)
  .then(allData => {
    console.log('所有工作表数据已获取：', allData);
    // 这里可以做后续处理：合并数据、清洗分析、导出等
  })
  .catch(err => console.error('请求出错：', err));

• 确保你的授权账号（不管是OAuth2用户账号还是服务账号）拥有目标电子表格的读取权限
• 如果你的工作表数量超过50个，建议分批次调用batchGet，避免单次请求参数过多被限制
• 如果只需要工作表的特定区域（比如A1:D100），直接把范围改成工作表标题!A1:D100即可

内容的提问来源于stack exchange，提问作者Dženis H.