如何实现Google Sheets插件安装后在扩展菜单显示带图指引？

要实现安装后在扩展菜单中展示带图片的操作指引，正确的方式是结合安装触发器、自定义菜单与侧边栏/对话框，以下是具体步骤和代码：

1. 核心实现逻辑 #

利用onInstall触发器在用户首次安装时初始化菜单，同时提供可主动调用的指引入口；通过HTML侧边栏承载带图片的指引内容，完全匹配扩展菜单的展示需求。

2. 代码实现 #

2.1 脚本文件（Code.gs） #

// 安装时触发，初始化菜单并可自动打开指引
function onInstall(e) {
  onOpen(e);
  showGuidanceSidebar(); // 可选：安装后自动弹出指引，引导用户
}

// 打开表格时触发，创建扩展菜单
function onOpen(e) {
  SpreadsheetApp.getUi()
    .createMenu('你的插件名称') // 替换为你的插件实际名称
    .addItem('📖 查看操作指引', 'showGuidanceSidebar')
    .addToUi();
}

// 打开带图片的指引侧边栏
function showGuidanceSidebar() {
  const htmlContent = HtmlService.createHtmlOutputFromFile('Guidance')
    .setTitle('插件操作指引')
    .setWidth(320);
  SpreadsheetApp.getUi().showSidebar(htmlContent);
}

2.2 指引页面（Guidance.html） #

创建HTML文件承载带图片的指引内容，图片需使用公开可访问的URL（如Google Drive公开分享链接、CDN链接等）：

<!DOCTYPE html>
<html>
<head>
  <base target="_top">
  <style>
    .guide-wrap { padding: 16px; font-family: system-ui, sans-serif; }
    .guide-step { margin: 24px 0; }
    .guide-img { width: 100%; border-radius: 6px; box-shadow: 0 2px 8px rgba(0,0,0,0.1); }
    .guide-title { color: #202124; font-size: 18px; }
    .guide-desc { color: #5f6368; margin: 8px 0 12px; }
  </style>
</head>
<body>
  <div class="guide-wrap">
    <h2 class="guide-title">欢迎使用你的插件！</h2>
    <div class="guide-step">
      <p class="guide-desc">第一步：点击顶部菜单栏的「扩展」选项</p>
      <img class="guide-img" src="替换为你的指引图片URL" alt="点击扩展菜单">
    </div>
    <div class="guide-step">
      <p class="guide-desc">第二步：在下拉菜单中找到「你的插件名称」，选择对应功能</p>
      <img class="guide-img" src="替换为你的指引图片URL" alt="选择插件功能">
    </div>
    <p class="guide-desc">后续使用可随时通过扩展菜单打开此指引～</p>
  </div>
</body>
</html>

2.3 配置manifest（appsscript.json） #

确保配置正确的权限，避免权限不足问题：

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

3. 为什么之前的方案失效？ #

• 旧manifest字段（onInstallation、homepageUrl）已被Google Apps Script废弃，当前版本的manifest不再支持这些字段，因此会触发结构错误。
• 工具栏右侧展示的方案是使用了自定义工具栏按钮API，不符合你需要的扩展菜单入口需求。

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