如何通过Google Sheets API无需手动指定范围获取全表已填充数据

不需要手动指定A1格式的固定行列范围，两种方案可适配列数、行数动态变化的场景，始终拉取到所有已填充数据：

• 最简方案（90%场景适用）
  直接将range参数设置为目标工作表的名称即可，API会自动识别该工作表内所有存在填充内容的单元格区域，自动覆盖所有有数据的行和列，不会拉取无意义的空单元格，也不需要提前知道表的列数、行数。
  示例代码（假设目标工作表名为业务明细）：

  sheet = service.spreadsheets().values().get(
      spreadsheetId=spreadsheet_id,
      range='业务明细'
  ).execute()
  

  如果工作表名包含空格、特殊符号，直接传入原名称即可，无需额外转义处理。返回结果的values字段就是全量已填充数据，后续表内增删行、增删列都不需要修改代码。
• 精准范围方案（适配边缘残留格式/空值场景）
  如果曾在工作表远离核心数据的位置编辑过内容、残留过单元格格式，可能导致API判定的已使用范围比实际数据范围大，返回多余空行空列，此时可以先拉取工作表元数据解析真实数据边界，再拉取准确数据：

  # 拉取工作表元数据，获取真实数据的行列边界
  sheet_meta = service.spreadsheets().get(
      spreadsheetId=spreadsheet_id,
      ranges='业务明细',
      fields='sheets.data.rowData.values(effectiveValue)'
  ).execute()
  # 计算真实数据的最大行、最大列
  row_data = sheet_meta['sheets'][0]['data'][0]['rowData']
  max_row = len(row_data)
  max_col = max([len(row.get('values', [])) for row in row_data])
  # 列索引转A1列名，拼接真实数据范围
  from openpyxl.utils import get_column_letter
  accurate_range = f'业务明细!A1:{get_column_letter(max_col)}{max_row}'
  # 拉取精准范围的全量数据
  sheet = service.spreadsheets().values().get(
      spreadsheetId=spreadsheet_id,
      range=accurate_range
  ).execute()
  

补充说明：不要用工作表名!A:ZZ这类整列范围写法，会拉取大量空行数据，大幅增加接口响应耗时，还可能触发接口数据量限制。

内容的提问来源于stack exchange，提问作者Semyon Kapustnikov