如何为Google Sheet添加onOpen触发器？绑定脚本的保存部署执行方法

我已运行过几个独立的“hello world类型脚本”，但无法运行这段绑定在Google Sheet中的onOpen脚本，运行按钮呈灰色（附相关截图）。代码如下：

/**
 * The event handler triggered when opening the spreadsheet.
 * @param {Event} e The onOpen event.
 */
function onOpen(e) {
  // Add a custom menu to the spreadsheet.
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp, or FormApp.
      .createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addToUi();
}

请问该绑定脚本应如何保存、部署和执行？

1. 保存脚本 #

直接点击脚本编辑器左上角的保存图标（💾），给脚本设置任意名称即可，绑定在Google Sheet的脚本不需要单独部署为Web应用。

2. 运行按钮灰色的原因 #

onOpen是Google Apps Script的简单触发函数，这类函数专门由系统事件（比如打开Sheet）自动触发，不能通过脚本编辑器的运行按钮直接执行——因为手动运行时不会传入函数声明里的Event参数e，所以按钮会置灰。

3. 执行与测试方法 #

• 自动触发：关闭当前Google Sheet，重新打开，系统会自动执行onOpen函数，此时Sheet顶部导航栏会出现代码里定义的「Custom Menu」菜单。
• 手动模拟触发：如果不想关闭Sheet，可以新建一个测试函数来调用onOpen：

  function testOnOpen() {
    onOpen(); // 你的代码未用到e参数，直接调用即可
  }
  

  选中testOnOpen函数，点击运行按钮，完成首次权限授权后，就能看到自定义菜单出现在Sheet中。

4. 关键注意事项 #

第一次运行相关函数时会弹出权限授权提示，按照页面指引完成验证即可，授权后函数才能正常触发执行。

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