关于Gmail API权限范围gmail.addons.current.action.compose的使用问询

一、“与插件交互”的具体含义 #

这个权限的核心限定是必须在用户主动触发插件的特定交互流程内才能生效，具体场景包括：

• 用户在Gmail界面内点击插件提供的按钮、卡片操作（比如点击“撰写邮件”类的插件控件）
• 用户通过插件的交互式界面发起的邮件撰写请求，而非插件后台静默执行的操作
  简单来说，这个权限绑定的是“用户主动和插件交互触发的即时动作”，而非插件自主运行的任务。

二、使用该权限发送邮件的限制条件 #

要通过这个权限成功发送邮件，必须满足以下所有要求：

• 触发方式限制：必须由用户在插件的交互界面内主动触发发送操作，不能由插件后台自动执行（比如定时发送、无用户操作的自动触发都不允许）
• 上下文限制：操作必须关联到当前用户正在使用的Gmail插件会话，不能脱离Gmail的插件运行上下文（比如在表格插件里直接调用这个权限发邮件就不符合要求，因为运行上下文是表格而非Gmail插件的交互流程）
• 操作流程限制：邮件必须是通过插件唤起的Gmail原生撰写界面完成编辑，或者插件在用户交互过程中生成草稿并由用户确认发送，不能由插件直接调用API发送，必须经过用户的显式确认步骤
• 权限范围的严格绑定：该权限仅能处理“与当前插件交互动作直接关联”的邮件，不能用于批量发送、处理用户未触发的其他邮件任务

补充说明 #

你提到的表格插件场景，由于运行上下文是Google表格而非Gmail插件的交互流程，所以gmail.addons.current.action.compose权限无法满足发送需求——这个权限的设计初衷是服务于Gmail内部的插件交互，跨应用（比如表格调用）不在其生效范围内，这也是你必须升级到gmail.send才能实现功能的核心原因。

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