Google Workspace Add-on中Sheets、Slides无法获取对应事件对象的问题咨询

• Docs、Sheets、Slides三个宿主的事件字段注入规则未对齐：Docs作为最早支持编辑器Add-on的宿主，默认会在事件对象顶层注入docs结构化字段，仅靠通用Drive文件权限就能正常返回。但Sheets、Slides有两个硬性前置要求，缺任意一个都不会在事件对象顶层返回对应的sheets/slides字段：
  • 仅靠通用drive.file权限scope，不足以触发Sheets、Slides的宿主结构化字段注入，必须额外声明对应宿主的当前文件级专属scope
  • Sheets、Slides在完成文件权限授权后，不会像Docs一样在授权完成的回调事件里即时注入宿主字段，必须重新加载整个宿主文档页面，字段才会被填充到后续的事件对象里
• 临时测试部署的限制：如果使用Apps Script编辑器的临时测试链接加载Add-on，Sheets、Slides环境下经常会出现配置不生效、事件字段缺失的问题，和配置正确性无关，是临时部署的已知行为。

• 补全OAuth scope配置，在manifest的oauthScopes数组中新增两个scope：
  • 适配Sheets场景：https://www.googleapis.com/auth/spreadsheets.currentonly
  • 适配Slides场景：https://www.googleapis.com/auth/presentations.currentonly
    两个scope都属于当前文件级权限，和现有drive.file的权限范围完全匹配，不会触发额外的用户授权弹窗。
• 调整授权回调的交互逻辑：在onFileScopeGrantedEditors函数返回的卡片中，增加提示文本，引导用户手动刷新当前的Sheets/Slides页面，不要直接在首次授权回调里依赖获取到的宿主对象渲染内容。
• 更新Add-on的部署版本：将Apps Script项目的部署类型从临时测试链接，切换为固定版本的Web App部署，确保所有manifest配置变更同步到宿主环境；如果是通过Workspace内部分发的Add-on，要上传最新的manifest配置重新发布，等待平台完成缓存同步。
• 验证流程：重新加载Sheets/Slides文档后，打开Add-on侧边栏，查看控制台打印的事件对象，确认顶层路径下已经存在sheets/slides字段，且包含id、title、addonHasFileScopePermission三个属性即可。

• 不要错误地从commonEventObject节点下查找Sheets/Slides的结构化字段，平台规则和Docs保持一致，所有宿主专属字段都在事件对象的顶层，对应取值路径就是e.sheets、e.slides。
• 授权流程中调用的requestFileScopeForActiveDocument方法不需要修改，这个方法本身是跨宿主兼容的，只要scope配置正确，就可以正常触发权限申请弹窗。

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