如何通过AppsScript编程根据URL打开Google Spreadsheet指定Sheet

目前Google Apps Script的SpreadsheetApp原生服务确实没有提供getSheetById()这类直接通过gid获取工作表的官方API，除了你当前使用的解析gid后遍历匹配的方案外，还有两个可选择的实现方向：

方案1：封装通用工具函数优化遍历逻辑 #

对于工作表数量较少的绝大多数场景（单表格工作表数少于20个），遍历匹配的性能损耗完全可以忽略，你可以把相关逻辑封装成可复用的工具函数，减少重复代码：

// 传入带gid的表格URL，直接返回对应工作表对象，匹配失败返回null
function getSheetBySpreadsheetUrl(url) {
  // 从URL哈希中解析gid参数
  const gidReg = /#gid=(\d+)/;
  const gidMatchRes = url.match(gidReg);
  if (!gidMatchRes) return null;
  const targetGid = parseInt(gidMatchRes[1], 10);

  const targetSpreadsheet = SpreadsheetApp.openByUrl(url);
  // 遍历所有工作表匹配id
  return targetSpreadsheet.getSheets().find(sheet => sheet.getSheetId() === targetGid) || null;
}

方案2：使用Sheets高级服务优化大表查询性能 #

如果目标表格的工作表数量非常多（几十上百个），且需要高频调用该能力，可以开启Apps Script的「Sheets」高级服务，通过API拉取工作表元数据后匹配，速度优于遍历SpreadsheetApp的Sheet对象：

1. 首先在Apps Script编辑器左侧「服务」菜单中找到并添加「Sheets」API服务
2. 使用如下代码实现：

function getSheetByUrlWithSheetsAPI(url) {
  // 解析表格ID和目标gid
  const sprdIdReg = /\/d\/([a-zA-Z0-9-_]+)\//;
  const gidReg = /#gid=(\d+)/;
  const sprdIdMatch = url.match(sprdIdReg);
  const gidMatch = url.match(gidReg);
  if (!sprdIdMatch || !gidMatch) return null;

  const sprdId = sprdIdMatch[1];
  const targetGid = gidMatch[1];
  // 仅拉取工作表元数据，不需要获取单元格内容，响应速度快
  const sheetsMeta = Sheets.Spreadsheets.get(sprdId, {
    fields: "sheets(properties(sheetId,title))"
  }).sheets;

  // 匹配到目标工作表名称后直接调用getSheetByName获取对象
  const targetSheetMeta = sheetsMeta.find(meta => meta.properties.sheetId.toString() === targetGid);
  if (!targetSheetMeta) return null;
  return SpreadsheetApp.openById(sprdId).getSheetByName(targetSheetMeta.properties.title);
}

另外需要注意：非UI上下文下不要依赖getActiveSheet()的返回值，官方明确标注该接口仅返回UI中当前激活的工作表，后台脚本运行时无UI上下文，默认返回表格第一个工作表，和URL携带的gid参数无关。

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