如何获取Gmail插件中创建新触发器的权限？

这个权限问题我之前碰到过好几次，核心原因是Gmail插件属于受限的运行环境，直接调用ScriptApp.newTrigger()需要额外声明OAuth权限，普通的默认权限覆盖不到这块。咱们一步步来搞定：

• 第一步：添加所需的OAuth权限范围
  创建时间驱动触发器必须用到https://www.googleapis.com/auth/script.scriptapp这个权限范围。你需要在脚本的清单文件里明确声明它：

  1. 打开你的Google Apps Script项目，点击左侧菜单栏的「项目设置」，勾选「显示appsscript.json清单文件」。
  2. 打开appsscript.json文件，找到oauthScopes数组，把这个权限范围添加进去。比如你的清单里已有Gmail插件的基础权限，修改后大概是这样：

     "oauthScopes": [
       "https://www.googleapis.com/auth/gmail.addons.execute",
       "https://www.googleapis.com/auth/script.scriptapp"
     ]
     

  注意不要删掉原有已有的权限，直接追加就行。

• 第二步：重新部署插件并重新授权
  修改完清单文件后，必须重新部署插件才能让新权限生效：

  1. 点击菜单栏的「部署」→「测试部署」或者「新部署」，选择「Gmail插件」作为部署类型。
  2. 更新插件版本（如果是已有部署，选择「更新现有部署」并升级版本号）。
  3. 部署完成后，用户需要重新授权插件——可以在Gmail里暂时移除插件再重新添加，或者在授权管理里找到该插件重新授权，这样新的权限就会被授予。

• 额外的注意事项

  • 时间驱动触发器在Gmail插件里有一定限制：比如你用的.after(5*1000)这种延迟触发器，运行时是在后台环境，完全脱离插件的UI上下文，所以你的timedFunction里不能依赖任何界面相关的对象或方法，只能做纯后台的逻辑（比如修改数据、发送邮件等）。
  • 如果你的需求是在用户操作后短暂延迟执行某个UI相关的功能，其实更适合用客户端的JavaScript计时器（比如setTimeout），但这种方式会受用户关闭标签页的影响；如果必须在后台执行，那上面的权限配置就是必要的。

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