如何通过Google Sheets API获取筛选后的电子表格数据

setBasicFilter 是 Google Sheets API 中专门用于操作表格内置筛选器的方法，设计定位仅修改表格的视图展示规则，不会返回筛选匹配的行数据，因此调用后接口仅返回操作成功的空响应属于预期行为。

可行解决方案 #

• 方案1：本地过滤全量数据
  调用setBasicFilter完成视图设置后，再调用spreadsheets.values.get接口拉取目标范围的全量数据，在业务代码中按照你设置的筛选、排序规则自行处理：
  1. 筛选规则对应：检查索引为2的列文本是否包含用户输入的关键词
  2. 排序规则对应：先按索引为0的列降序排列，再按索引为2的列升序排列
     该方案实现简单，适合数据量较小的场景。
• 方案2：直接用查询语法获取筛选结果（推荐）
  不调用setBasicFilter，直接使用 Google Visualization API 的查询语法拉取已过滤排序的结果集，无需拉取全量数据，性能更高，且不会修改原表格的视图配置，不会影响其他访问表格的用户。
  对应你的需求的查询语句为：

  select * where C contains '用户输入的关键词' order by A desc, C asc
  

  将上述语句作为tq参数传入请求即可直接得到匹配的数据集。
• 方案3：组合调用满足双需求
  如果你既需要修改表格的视图筛选器，又需要获取筛选后的数据，可以先调用setBasicFilter更新视图，再调用方案2的查询接口拉取结果，两步操作即可同时满足两个需求。

注意事项 #

如果你的表格是多用户共享的，优先选择方案2，避免修改全局筛选器影响其他用户的正常使用。

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