如何用Google Script实现Google Sheet按钮触发Add-ons默认子菜单功能

核心限制说明 #

Google Apps Script 未开放直接模拟点击Add-ons菜单UI交互的接口，安全机制也会拦截所有模拟前端用户操作的脚本行为，无法通过脚本直接唤起Add-ons菜单下某个功能的原生弹窗界面。但所有需要点击菜单实现的功能逻辑，基本都可以通过脚本直接调用对应后台能力，实现完全等效的效果。

分场景实现路径 #

• 针对Google官方自带的Add-ons功能
  直接在按钮绑定的脚本内调用功能对应的官方公开API即可，无需走菜单触发流程。例如要实现等效于菜单里“添加受保护范围”的功能，可直接编写如下脚本绑定到按钮：

  // 为当前选中区域设置保护规则，等效菜单操作
  function protectActiveRange() {
    const activeRange = SpreadsheetApp.getActiveSpreadsheet().getActiveRange();
    const protectionRule = activeRange.protect();
    protectionRule.setDescription('按钮触发的保护规则');
  }
  

• 针对第三方发布的Add-ons功能
  先确认目标插件是否开放了可独立调用的Apps Script接口。绝大多数正规发布的插件都会在说明文档中提供可直接调用的脚本方法，只需在按钮绑定的脚本中引入、调用对应方法，就能得到和点击菜单完全一致的执行效果。
  如果目标第三方插件没有开放公开接口，只能通过复刻其核心功能逻辑实现等效操作，无法直接唤起该插件的原生交互弹窗。

避坑提示 #

不要尝试通过模拟DOM点击、UI操作的方式绕过菜单触发流程，这类操作会被Google的跨域安全策略拦截，会频繁触发权限校验失败，不存在长期稳定的可用实现方案。

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