已安装的Google Docs Apps Script扩展程序显示灰色无法使用
问题描述
我已获得管理员权限,将开发的Apps Script扩展发布至内部Google Marketplace(类似文档翻译类的编辑器扩展)。开发测试阶段该扩展可正常使用(
),但通过Google Marketplace正式安装后,扩展变为灰色不可用(
、
、
)。
我已在appsscript.json中配置了必要的OAuth权限:
"oauthScopes": [ "https://www.googleapis.com/auth/documents", "https://www.googleapis.com/auth/script.external_request", "https://www.googleapis.com/auth/script.container.ui" ],
请问我的应用出现了什么问题?
可能的原因及解决方法
- 编辑器关联配置错误:检查Marketplace发布设置里,是否正确勾选了目标编辑器(比如Docs、Sheets)。测试阶段是直接绑定编辑器的,但正式发布时如果选错了编辑器类型,扩展会因不匹配而灰显。
- OAuth权限未完成授权:虽然你在脚本里配置了权限,但内部Marketplace发布后,管理员需要在Google Workspace管理控制台中确认授予该扩展权限。进入控制台的「应用」-「Marketplace应用」,找到你的扩展,检查权限状态是否为已授权。
- 发布版本错误:确认发布到Marketplace的是已部署的正式版本,而非草稿版本。测试阶段用的可能是草稿部署,正式发布时如果选错版本,会导致扩展加载异常。
- 脚本类型不匹配:如果你的脚本是绑定到特定文档的容器脚本,而非独立的编辑器扩展,发布到Marketplace后无法全局生效,会导致灰显。要确保脚本是作为编辑器扩展开发的,而非容器绑定脚本。
- Manifest配置缺失:检查
appsscript.json中是否有完整的addOns配置,比如针对Docs的触发设置:
"addOns": { "docs": { "homepageTrigger": { "runFunction": "showSidebar", "enabled": true } } }
缺少这类配置的话,扩展无法在编辑器中激活,会显示灰色。
内容的提问来源于stack exchange,提问作者chaooder
相关产品推荐
相关产品推荐

