Google Sheets插件无法同时显示主页卡片与插件菜单问题

核心问题分析 #

测试环境和应用市场部署后的表现差异，根源在于两类功能的触发逻辑在不同环境下的权限与加载机制不同：

• 测试环境中，onOpen触发的菜单需要用户授权才能显示，但主页卡片（homepageTrigger）在测试阶段默认处于授权状态，因此出现卡片显示、菜单不显示的情况。
• 部署到应用市场后，用户安装时会完成基础授权，菜单能正常加载，但主页卡片需要满足特定配置规则才会触发展示。

分步修复方案 #

1. 调整菜单触发逻辑 #

将菜单创建逻辑同时绑定到onInstall和onOpen函数，确保首次安装和每次打开表格都能生成菜单：

function onInstall(e) {
  onOpen(e);
}

function onOpen(e) {
  SpreadsheetApp.getUi()
    .createAddonMenu()
    .addItem('功能入口1', 'triggerFunction1')
    .addItem('功能入口2', 'triggerFunction2')
    .addToUi();
}

测试环境下手动执行一次onInstall函数完成授权，刷新表格后菜单即可显示；部署后用户安装插件时会自动触发onInstall，菜单正常加载。

2. 修正homepageTrigger配置 #

检查并更新appscript.json中的homepageTrigger配置，需同时在通用配置和对应编辑器（Sheets）下声明：

{
  "timeZone": "Asia/Shanghai",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "addOns": {
    "common": {
      "name": "你的插件名称",
      "logoUrl": "https://你的图标地址/logo.png",
      "layoutProperties": {
        "primaryColor": "#4285F4"
      },
      "homepageTrigger": {
        "runFunction": "renderHomepageCard",
        "enabled": true
      }
    },
    "sheets": {
      "homepageTrigger": {
        "runFunction": "renderHomepageCard",
        "enabled": true
      }
    }
  }
}

同时确保指定的渲染函数返回合法的卡片结构：

function renderHomepageCard() {
  return CardService.newCardBuilder()
    .setHeader(CardService.newCardHeader().setTitle('插件主页'))
    .addSection(CardService.newCardSection()
      .addWidget(CardService.newTextParagraph().setText('欢迎使用本插件')))
    .build();
}

3. 测试与部署注意事项 #

• 测试环境：手动执行onInstall完成授权后，刷新表格即可同时看到菜单和卡片。
• 应用市场部署：确认提交的版本中appscript.json配置无遗漏，且插件OAuth权限范围包含必要项（如https://www.googleapis.com/auth/spreadsheets）。

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