如何通过用户令牌认证，使用GViz查询Google Sheets获取过滤结果？

方案1：使用Sheets API + 自定义过滤逻辑 #

虽然Sheets API v4没有原生支持GViz类SQL查询，但可以先通过API获取原始数据，再在本地实现过滤逻辑，完全适配你手里的用户令牌：

• 确保权限范围包含https://www.googleapis.com/auth/spreadsheets.readonly（或对应读写权限），直接在请求头中携带令牌完成认证：

  curl "https://sheets.googleapis.com/v4/spreadsheets/{SPREADSHEET_ID}/values/{RANGE}" \
    -H "Authorization: Bearer {YOUR_ACCESS_TOKEN}"
  

• 获取到数据后，用代码实现GViz查询对应的逻辑，比如要筛选SELECT A, B WHERE C > 100，就遍历返回的values数组，提取符合条件的行和列。这种方式无需依赖额外服务，适合简单过滤场景。

方案2：通过Google Apps Script搭建中转服务（完美适配GViz查询语法） #

如果必须使用GViz的类SQL语法，可以用Google Apps Script创建一个中转Web App，实现OAuth认证+GViz查询的能力：

1. 在目标表格中创建Apps Script项目，编写如下核心代码（支持CSV输出）：

   function doGet(e) {
     const queryStr = e.parameter.tq;
     if (!queryStr) return ContentService.createTextOutput("Missing tq parameter").setMimeType(ContentService.MimeType.TEXT);
     
     const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
     const query = new google.visualization.Query(sheet.getUrl());
     query.setQuery(queryStr);
     const response = query.send();
     
     if (response.isError()) {
       return ContentService.createTextOutput(`Query Error: ${response.getMessage()}`).setMimeType(ContentService.MimeType.TEXT);
     }
     
     // 转换为CSV格式
     const dataTable = response.getDataTable();
     let csvContent = '';
     // 写入表头
     const headers = [];
     for (let i = 0; i < dataTable.getNumberOfColumns(); i++) {
       headers.push(`"${dataTable.getColumnLabel(i)}"`);
     }
     csvContent += headers.join(',') + '\n';
     // 写入行数据
     for (let row = 0; row < dataTable.getNumberOfRows(); row++) {
       const rowData = [];
       for (let col = 0; col < dataTable.getNumberOfColumns(); col++) {
         rowData.push(`"${dataTable.getValue(row, col)}"`);
       }
       csvContent += rowData.join(',') + '\n';
     }
     
     return ContentService.createTextOutput(csvContent).setMimeType(ContentService.MimeType.CSV);
   }
   

2. 部署Web App时，选择**"以访问Web应用的用户身份执行"**，这样Web App会继承请求用户的权限，直接用你手里的令牌认证：
   • 客户端请求示例：

     curl "https://script.google.com/macros/s/{WEB_APP_DEPLOYMENT_ID}/exec?tq={YOUR_GVIZ_QUERY}" \
       -H "Authorization: Bearer {YOUR_ACCESS_TOKEN}"
     

注意事项 #

原生的tq公开端点仅支持公开共享的表格，不支持OAuth2令牌认证，无法用于私有表格的权限验证，因此上述两种方案是当前的可行路径。

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