无法部署更新Gmail App Script扩展版本，需额外配置吗？

以下是需要检查和配置的关键环节：

1. 部署环节的核心设置 #

• 确保部署类型正确：选择「Gmail 插件」（原Gmail Add-on）适配的部署类型，而非普通Web应用。
• 创建正式版本：每次更新后，必须通过「部署」→「管理部署」→「新建版本」生成带版本号的正式部署，而非临时测试部署。版本创建完成后，复制该版本的部署ID备用。
• 权限设置：部署权限需设为「任何人」（针对公开/团队内部应用），确保应用市场用户能正常访问。

2. 关联Google Workspace Marketplace SDK配置 #

• 确认云项目关联一致：App Script项目需绑定到你用于发布应用的Google Cloud项目（在App Script「项目设置」→「Google Cloud Platform项目」中切换绑定）。
• 更新SDK中的部署信息：登录Google Cloud Console的Marketplace SDK页面，找到你的应用，在「配置」标签下将「部署ID」替换为刚生成的新版本ID，保存配置。

3. 权限与API验证 #

• 检查OAuth范围：在App Script「项目设置」→「OAuth 范围」中，确保仅请求必要的权限（比如仅https://www.googleapis.com/auth/gmail.modify而非全权限），多余敏感权限会导致审核失败或无法同步。
• 启用必要API：在Google Cloud Console的API库中，启用「Gmail API」和「Apps Script API」，否则扩展无法正常运行。

4. 发布流程确认 #

• 公开应用：若应用面向外部用户，更新版本后需重新提交审核，在Marketplace SDK的「发布」标签下选择「更新发布」，等待Google审核通过后才会同步到应用市场。
• 内部团队应用：确认在Marketplace SDK中已将新版本设置为「活跃版本」，无需审核即可同步给团队成员。

5. 客户端缓存清理 #

测试时打开浏览器隐私模式访问Gmail，或清除Gmail的缓存（设置→查看所有设置→隐私和数据→清除缓存），避免因客户端缓存导致无法加载新版本。

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