Google Sheets API v4调用addFilterView报No grid with id错误求助

• sheetId 是 Google Sheets 为每个工作表分配的永久唯一标识，删除工作表后对应的 ID 不会被回收复用，新增工作表的 ID 会持续递增，不会填补之前删除产生的 ID 空缺，不存在「第一个工作表ID是0、第二个是1、第三个是2」的固定规则。
• 你对「存在对应sheetId的工作表」的验证基于经验假设，没有调用API获取真实的有效ID，导致硬编码的ID对应的工作表早已被删除，这就是旧表格必现报错、新表格初始能用ID0的核心原因。
• 你新增工作表后尝试使用ID1报错，是因为这个ID对应的工作表早就被删除了，新增的工作表ID远大于1，根本不是1。

1. 先调用spreadsheets.get接口拉取目标表格的全量工作表元数据，获取真实存在的sheetId，禁止硬编码ID值，示例代码如下：

// 拉取表格所有工作表信息
const spreadsheetRes = await sheets.spreadsheets.get({
  spreadsheetId: '替换为你的目标表格ID'
});
// 按工作表名称匹配获取对应的有效sheetId，示例取名为「数据汇总」的工作表ID
const targetSheet = spreadsheetRes.data.sheets.find(sheet => sheet.properties.title === '数据汇总');
const targetSheetId = targetSheet.properties.sheetId;

2. 将addFilterView请求中range下的sheetId替换为上述步骤拿到的有效值即可。
3. 额外注意：filterViewId也是表格内全局唯一值，如果你之前创建过相同ID的筛选视图，会触发重复ID报错，建议创建前先查询已有筛选视图列表，或者动态生成唯一ID避免冲突。

你可以直接在浏览器打开目标表格，切换到要操作的工作表，地址栏中gid=参数后面的数值就是该工作表的真实sheetId，直接将该值填入请求中测试，即可排除ID无效导致的报错。

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