无法保存appsscript.json修改，如何限制Gmail只读权限？

一、appsscript.json 保存失败的解决方法 #

1. 确认权限范围拼写准确
   必须使用Gmail只读的官方权限范围：https://www.googleapis.com/auth/gmail.readonly，不能出现拼写错误或多余字符。
2. 检查清单文件格式合法性
   严格遵循JSON语法规则，示例正确结构如下：

   {
     "timeZone": "Asia/Shanghai",
     "dependencies": {},
     "exceptionLogging": "STACKDRIVER",
     "oauthScopes": [
       "https://www.googleapis.com/auth/spreadsheets",
       "https://www.googleapis.com/auth/gmail.readonly"
     ],
     "runtimeVersion": "V8"
   }
   

   注意：数组最后一项不能加逗号，所有引号必须是双引号，确保没有语法错误。
3. 排查企业环境限制
   Google Workspace域管理员可能会限制用户修改OAuth权限清单，需要联系管理员确认是否允许自定义脚本的权限范围。
4. 尝试无干扰环境操作
   用无痕模式打开脚本编辑器，排除浏览器缓存、插件的干扰；修改后点击顶部「保存项目」按钮，等待系统完成保存再刷新页面，不要操作过快。

二、关于/** @OnlyCurrentDoc */注释的作用 #

这个注释无法实现Gmail只读权限限制。它的作用仅在于缩小脚本对当前Google表格的访问范围（仅请求当前表格的权限，而非整个Drive），对Gmail这类外部服务的权限控制无效。Gmail的权限必须通过appsscript.json中的oauthScopes字段指定。

额外说明 #

个人Gmail环境中出现的「无效更改」错误，本质是清单文件存在语法问题，但企业环境可能因域策略隐藏了具体错误提示，导致仅显示「正在保存项目...」的状态。

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