如何用googleapis npm包查询Google Sheet（服务账号认证场景）

方法1：通过API的dataFilters参数实现服务端筛选 #

你当前使用的batchGet方法支持用dataFilters替代ranges，直接在服务端完成数据过滤，无需拉取全量内容。这种方式能减少传输的数据量，效率更高。

示例代码：

const standardSpreadsheetData = await sheets.spreadsheets.values.batchGet({
  auth,
  spreadsheetId: regularSpreadsheetId,
  dataFilters: [
    {
      range: {
        sheetId: 123456789, // 替换为目标标签页的ID（可在Sheet URL中获取）
        startRowIndex: 1, // 跳过表头（索引从0开始，对应第2行）
        startColumnIndex: 0,
        endColumnIndex: 6 // 按需指定列范围，减少数据传输
      },
      filterCriteria: {
        condition: {
          type: "TEXT_EQ",
          values: [{ userEnteredValue: "9831" }]
        },
        columnIndex: 1 // B列的索引为1（A列是0）
      }
    }
    // 若需要多个标签页，继续添加dataFilter对象即可
  ]
});

注：标签页ID可通过spreadsheets.get接口查询获取，也能直接从Sheet的URL中提取（URL中gid=后面的数字就是）。

方法2：拉取必要列后本地筛选 #

如果dataFilters的条件无法覆盖你的需求，可先只拉取筛选依据列（比如B列）和业务所需的其他列，再在本地代码中过滤符合条件的行，同样能降低数据传输量。

示例代码：

// 指定仅拉取需要的列，比如A、B、C列
const regularRanges = ["Sheet1!A:C"];
const rawData = await sheets.spreadsheets.values.batchGet({
  auth,
  spreadsheetId: regularSpreadsheetId,
  ranges: regularRanges,
});

// 提取数据并执行本地筛选
const filteredData = rawData.valueRanges[0].values?.filter(row => {
  // 处理空行或数据缺失的情况，确保B列存在且等于目标值
  return row[1] && row[1] === "9831";
}) || [];

方法3：用Google Apps Script搭建自定义筛选接口（备选） #

如果以上两种方法都不适用，可以在目标Google Sheet中编写Apps Script，创建一个支持筛选参数的自定义接口。比如编写一个getFilteredData函数，内部用Query逻辑处理数据，再将脚本部署为Web App，通过服务账号认证访问该接口获取筛选结果。

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