Google Docs插件发布至Chrome应用商店与G Suite时显示为Chrome扩展的问题

阿华AIGC实验室

2026-5-12

关于Google Docs插件被误识别为Chrome Extension的问题排查

我之前在Google Workspace开发者社区里见过不少同行遇到过和你一模一样的问题——就是把Docs插件提交到Chrome商店时，被误识别成普通Chrome Extension，尤其是在尝试未公开（unlisted）发布之后。结合你的情况和其他人的解决方案，给你整理几个排查方向：

一、先检查manifest.json的核心配置

从你贴的manifest来看，有几个关键配置可能导致系统误判：

Container字段不够精准：你设置的是["GOOGLE_DRIVE"]，但针对Google Docs专属插件，应该明确加上"DOCS"（如果同时要支持Drive可以写成["GOOGLE_DRIVE", "DOCS"]）。只写GOOGLE_DRIVE会让商店系统认为这是Drive相关的Chrome扩展，而非Docs插件。
缺少Google Workspace插件专属的addOns字段：标准的Docs插件manifest需要通过addOns.docs来声明和Docs的集成逻辑（比如侧边栏、菜单触发等），你当前的配置里完全没有这个字段，反而用了launch.web_url这种更偏向普通Chrome Web App的写法，这是误判的核心原因之一。举个正确的示例：
```
"addOns": {
  "docs": {
    "homepageTrigger": {
      "runFunction": "openDocsSidebar",
      "enabled": true
    }
  }
}
```
app.background配置冗余：对于Google Workspace插件来说，不需要配置app.background，这个字段是给普通Chrome扩展/应用用的，删掉它能减少系统的判断混淆。

未公开版本的缓存坑：第一次提交未公开版本时，Chrome商店可能会缓存初始的分类判断结果，哪怕你之后改了manifest，缓存也可能没更新。可以试试：
- 删除当前的未公开发布条目，重新创建一个新的提交
- 用无痕模式打开开发者后台，上传修改后的manifest，避免浏览器缓存干扰
手动指定分类：在提交页面，确认是否有选项可以手动选择「Google Workspace Add-on」分类，不要让系统自动判断。有些开发者就是因为没手动选，导致被分到了Chrome Extension里。