自定义后端Google Workspace Add-on无法在Gmail iOS端显示求助

这是Google Workspace Add-on Alternate Runtimes的已知平台局限，并非你的操作失误。

核心原因 #

Apps Script开发的插件是Google Workspace生态的原生实现，全平台（包括Gmail iOS）都提供支持；而基于自有后端的Alternate Runtimes方案，目前仅兼容以下场景：

• 桌面端Gmail
• Google Docs/Sheets/Forms的桌面及移动端

Gmail iOS端暂未纳入Alternate Runtimes的支持范围，因此插件无法正常显示。

可验证的排查步骤（确认自身操作无问题） #

• 检查后端返回的JSON卡片结构，确保完全符合官方规范，包括widget类型、布局参数、权限声明等细节
• 在桌面端Gmail测试自有后端插件，确认能正常加载卡片和执行功能，排除后端服务、OAuth配置或请求响应的问题
• 核对插件的部署配置，确保已正确关联自有后端的端点URL，且域名已完成Google验证

临时适配方案 #

如果需要覆盖Gmail iOS用户，可采用混合模式：

• 保留Apps Script版插件作为iOS端入口，通过Apps Script的UrlFetchApp调用自有后端API，复用核心业务逻辑
• 持续关注Google官方更新，Alternate Runtimes的平台支持范围可能会在后续版本中扩展

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