Google Apps Script表单提交触发器OAuth权限范围限制配置问题

解决方案 #

根因说明 #

表单提交触发器触发额外权限请求的核心原因是三个：旧授权缓存、触发器创建顺序错误，以及多余权限配置残留。

操作步骤 #

1. 清理旧的授权与触发器
   • 进入脚本编辑器的「触发器」页面，删除所有已创建的表单提交触发器
   • 打开你的Google账号「第三方应用和服务访问权限」页面，找到该脚本对应的授权项，完全移除授权，消除旧权限缓存
2. 优化配置文件与代码
   • 确认appsscript.json结构完整，oauthScopes放在根节点下，同时删除不必要的gmail.readonly权限（你的脚本仅需发信，无需读邮件权限），参考完整配置如下：

   {
     "timeZone": "你所在的时区，例如Asia/Shanghai",
     "dependencies": {},
     "oauthScopes": [
         "https://www.googleapis.com/auth/gmail.send",
         "https://www.googleapis.com/auth/spreadsheets.currentonly",
         "https://www.googleapis.com/auth/forms.currentonly"
     ],
     "runtimeVersion": "V8"
   }
   

   • 代码顶部的@OnlyCurrentDoc注解保留即可，无需修改
3. 按正确顺序授权并创建触发器
   • 回到脚本编辑页面，手动点击运行onFormSubmit函数，此时会弹出授权请求，确认显示的权限就是你配置的最小范围后完成授权（运行会报错，因为没有表单提交的事件参数，属于正常情况，不影响后续使用）
   • 授权完成后再进入触发器页面，新建触发器：事件源选择当前绑定的电子表格，事件类型选择「表单提交」，保存即可

验证 #

触发器创建完成后提交一次测试表单，确认邮件发送正常，且没有额外权限请求即可。

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