此前可正常运行的Gmail自动归档Google Apps Script现报授权错误,如何授权?
Gmail自动归档脚本授权错误修复步骤
这个报错的核心原因是脚本的定时运行触发绑定的授权凭据失效——常见触发场景包括账号密码修改、两步验证新增验证方式、Google对Gmail服务的OAuth权限规则更新、旧测试部署版本的凭据过期,定时运行时因为没有有效授权就会自动发送报错邮件。
具体操作流程
- 完成手动重新授权
- 打开你存放这个自动归档脚本的Google Apps Script项目,在顶部函数选择栏选定
gmailAutoarchive,点击上方的「运行」按钮。 - 按照弹出的授权引导,选择你对应的Gmail绑定账号,遇到“Google未验证应用”的提示时,点击「高级」→「前往脚本名称」进入权限确认页(该提示为个人自建脚本的常规提示,无实际安全风险)。
- 勾选所有和Gmail读写相关的权限选项,点击「允许」完成基础授权校验。如果第一次运行后提示缺少新的权限,再次点击「运行」按钮,按照引导完成二次授权即可。
- 打开你存放这个自动归档脚本的Google Apps Script项目,在顶部函数选择栏选定
- 清理旧的失效定时触发器
- 点击左侧边栏的「触发器」图标,找到和
gmailAutoarchive绑定的旧定时任务。 - 删除所有显示“授权失效”标识的旧触发器,按照你之前设置的运行周期(比如每1天运行1次),重新新建一个同规则的新触发器——新建触发器时系统会自动关联你刚完成的有效授权,不会残留旧的失效凭据缓存。
- 点击左侧边栏的「触发器」图标,找到和
- 可选优化:补充权限声明避免后续反复报错
在你的脚本代码开头添加JSDoc标记,显式声明脚本需要的Gmail权限范围,减少系统自动探测权限时出现的匹配偏差,添加后重新运行一次脚本完成授权即可:/** * @description 自动归档超期未读非重要、未标星邮件 */ function gmailAutoarchive() { // 原脚本代码放在这里 }
注意事项:
- 不要用临时测试部署的版本长期运行定时任务,测试产生的临时版本凭据会在7天后自动过期,需要使用正式部署的版本绑定触发器
- 如果你的账号是Google Workspace企业账号,需要确认管理员没有限制个人自建脚本的Gmail访问权限,权限管控开启时需要让管理员将你的脚本加入授权白名单
内容的提问来源于stack exchange,提问作者ekolis
相关产品推荐
相关产品推荐

