域级预安装Sheets插件异常：仅显示Help子菜单求助

我之前帮不少Workspace管理员解决过类似的域内插件部署问题，你的情况大概率是菜单逻辑、授权配置或者部署设置这几个环节出了问题，下面一步步拆解原因和解决方案：

一、最常见原因：菜单创建逻辑依赖授权状态 #

很多开发者会在onOpen或onInstall函数里加入授权状态判断，只有当用户完成授权（e.authMode === AUTHORIZED）时才显示完整菜单，未授权时只保留Help选项。但域内预安装不会自动完成用户授权，导致用户打开Sheets时插件检测到未授权，就只显示Help菜单。

解决方案：调整菜单创建逻辑 #

把菜单创建和授权检查分开，先显示所有菜单选项，再在用户点击功能选项时检查授权并引导用户完成：

function onOpen(e) {
  const ui = SpreadsheetApp.getUi();
  const addonMenu = ui.createMenu('你的插件名称')
    .addItem('核心功能', 'checkAuthBeforeRun')
    .addSeparator()
    .addItem('帮助', 'showHelp')
    .addToUi();
}

// 封装授权检查函数
function checkAuthBeforeRun() {
  try {
    // 尝试执行需要授权的核心功能
    coreFunction();
  } catch (authError) {
    // 捕获授权异常，引导用户授权
    const ui = SpreadsheetApp.getUi();
    const authDialog = HtmlService.createHtmlOutput(`
      <p>请先授权插件以使用核心功能：</p>
      <a href="${ScriptApp.getAuthorizationUrl()}" target="_blank">点击这里完成授权</a>
    `).setWidth(300).setHeight(150);
    ui.showModalDialog(authDialog, '授权插件');
  }
}

function coreFunction() {
  // 你的核心功能代码
}

function showHelp() {
  // 帮助菜单逻辑
}

二、域级权限或部署配置问题 #

如果菜单逻辑没问题，那可能是管理员端的部署或权限设置遗漏：

排查点1：确认插件的域内发布状态 #

在Apps Script后台：

• 进入「部署」>「管理部署」
• 确保你发布的版本是「已发布到域」，且目标受众设置为「你的整个域名」
• 避免使用「测试部署」，测试版本仅对特定测试用户可见

排查点2：检查Workspace管理员的权限批准 #

作为Workspace管理员，进入Admin控制台：

• 路径：「应用」>「Google Workspace」>「应用市场应用」>「托管应用」
• 找到你的插件，确认所有请求的OAuth权限都已被批准（如果有未批准的权限，插件会被限制功能）

三、域级委托（可选，针对无需用户手动授权的场景） #

如果你的插件需要后台访问用户Sheets数据，且不想让每个用户手动授权，可以配置域级权限委托：

1. 在Google Cloud控制台为插件创建服务账号，并下载密钥文件
2. 在Apps Script中使用服务账号的密钥，通过OAuth2库实现域级授权
3. 在Admin控制台中为服务账号授予所需的API权限（比如https://www.googleapis.com/auth/spreadsheets）
4. 这样插件可以直接以用户身份访问数据，无需用户手动授权，菜单也会完整显示

四、快速测试排查方法 #

• 用域内普通用户账号打开Sheets，进入「扩展程序」>「你的插件名称」>「查看日志」，看看是否有授权错误或菜单创建失败的日志
• 让用户手动重新安装插件（在Google Workspace应用市场搜索你的插件，点击「安装」），有时候预安装的缓存会导致版本不一致

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