如何在打开/创建Google Sheet时自动触发关联脚本的授权流程

问题根因 #

你当前的方案失效是因为默认的onOpen()属于简单触发器，运行在受限的无授权上下文中，所有需要OAuth权限的API调用（比如ScriptApp.getOAuthToken()）都会被静默拦截，无法触发授权流程。

可行方案 #

方案1：使用可安装onOpen触发器（无需修改代码） #

操作步骤：

• 打开母版表格关联的Apps Script项目，点击左侧菜单栏的「触发器」（时钟形状图标）
• 点击右下角「添加触发器」，按以下配置填写：
  • 选择要运行的函数：选择你现有的onOpen函数
  • 选择要运行的部署版本：选择「HEAD」
  • 选择事件来源：「电子表格」
  • 选择事件类型：「打开时」
• 点击保存，按提示完成开发者侧的授权即可

注意：用户首次打开自己复制的表格时，会直接收到全局授权提示，完成授权后触发器会自动激活，后续打开无需重复操作。

方案2：新增初始化授权引导（兼容性更强，适配所有副本场景） #

不需要配置触发器，所有用户打开副本即可看到授权提示：

1. 修改你的onOpen函数，新增授权引导，同时菜单增加授权入口：

function onOpen() {
  const ui = SpreadsheetApp.getUi();
  // 首次打开弹出授权提示
  ui.alert('使用提示', '首次使用请先点击菜单「AutoFill Exceptions Slides」-「完成首次授权」，授权后即可正常生成幻灯片', ui.ButtonSet.OK);
  const menu = ui.createMenu('AutoFill Exceptions Slides');
  menu.addItem('完成首次授权', 'triggerAuth');
  menu.addItem('Generate Slides', 'createNewGoogleSlides');
  menu.addToUi();
}

// 仅用于唤起授权流程的触发函数
function triggerAuth() {
  // 调用任意需要权限的API即可触发授权弹窗
  ScriptApp.getOAuthToken();
  SpreadsheetApp.getUi().alert('授权完成，现在可以正常使用生成幻灯片功能');
}

2. （可选）明确声明权限范围避免授权不全
   打开Apps Script项目的「项目设置」，勾选「在编辑器中显示appsscript.json清单文件」，回到编辑器打开appsscript.json，添加你需要的权限范围，示例如下，可根据脚本实际调用的服务调整：

{
  "timeZone": "Asia/Shanghai",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/spreadsheets.currentonly",
    "https://www.googleapis.com/auth/presentations",
    "https://www.googleapis.com/auth/script.container.ui"
  ]
}

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