共享表格中Spreadsheets.values.batchClear报404错误问题排查

核心原因：权限范围的访问限制差异 #

你遇到的404错误本质是spreadsheets.currentonly权限的范围限制导致的：

• https://www.googleapis.com/auth/spreadsheets.currentonly：这个权限仅允许脚本访问当前用户创建的、且与脚本绑定的表格。当你在共享表格中运行插件时，表格的创建者不是你，插件通过这个权限调用Sheets API时，API无法识别该共享表格（权限范围不包含这类资源），因此返回“Requested entity was not found”的404错误。
• https://www.googleapis.com/auth/spreadsheets：这个权限授予对用户拥有访问权限的所有Google Sheets表格的完整访问权，包括共享表格。更换后，API能正常识别并访问共享表格的资源，因此batchClear操作可以正常执行。

宏能正常运行的原因 #

宏是直接在表格的本地上下文环境中执行的，其权限验证基于表格本身的访问权限（你已经被授权访问该共享表格），不需要通过插件的全局权限范围去校验，因此即使使用currentonly权限，宏也能正常调用API。

建议 #

1. 根据插件的实际功能选择权限：
   • 如果插件仅需处理用户自己创建的、绑定插件的表格，保留spreadsheets.currentonly即可，遵循权限最小化原则。
   • 如果插件需要支持用户有权限的任意表格（包括共享表格），必须使用spreadsheets权限，同时在插件发布时明确说明权限用途，符合Google的应用审核规范。
2. 避免混用权限场景：确保插件的权限范围与实际要处理的资源类型匹配，避免因权限不足导致的资源访问错误。

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