寻求Gmail Add-on自动插入图片的无额外点击触发方案

问题描述 #

我们正在开发一款Gmail插件，需求是用户点击「撰写/回复/转发」按钮时，自动插入图片，不需要先展示UI再让用户点击操作。目前用现有触发机制必须先显示UI，用户点击后才能插入图片；尝试过compose triggers，但还是会出现一个额外的操作按钮，只有点击这个按钮才会插入图片，希望解决这个问题，实现无需额外操作直接插入图片。

核心问题分析 #

Gmail Add-on的compose triggers默认行为是在撰写窗口添加操作按钮，需要用户主动触发才能执行插入逻辑。要实现自动触发，需要调整插件配置和脚本逻辑，利用撰写窗口初始化时的触发事件直接执行插入操作。

解决方案步骤 #

1. 调整appscript.json配置 #

确保gmail字段下的composeTrigger配置正确，将初始化动作指向直接执行插入图片的函数，而非弹出UI的函数：

{
  "timeZone": "Asia/Shanghai",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/gmail.addons.execute",
    "https://www.googleapis.com/auth/gmail.compose",
    "https://www.googleapis.com/auth/gmail.modify"
  ],
  "gmail": {
    "name": "自动插入图片插件",
    "logoUrl": "https://your-logo-url.com",
    "contextualTriggers": [],
    "composeTrigger": {
      "selectActions": [],
      "draftAccess": "METADATA",
      "initializationActions": [
        {
          "runFunction": "insertImageAutomatically"
        }
      ]
    }
  }
}

关键配置是initializationActions中的runFunction，设置为你的自动插入图片函数，跳过UI展示步骤。

2. 修改code.js逻辑 #

编写insertImageAutomatically函数，直接获取当前撰写草稿并插入图片：

function insertImageAutomatically(e) {
  // 获取当前撰写的草稿ID
  const draftId = e.draftId;
  if (!draftId) return;

  // 准备图片内容（示例为Base64格式，也可替换为公网图片URL）
  const imageContent = `<img src="data:image/png;base64,你的图片Base64编码" alt="自动插入图片">`;

  // 获取草稿当前内容并拼接图片
  const draft = GmailApp.getDraft(draftId);
  const currentHtmlBody = draft.getMessage().getBody();
  const newHtmlBody = imageContent + currentHtmlBody;

  // 更新草稿内容
  draft.update(newHtmlBody, draft.getMessage().getSubject(), {
    htmlBody: newHtmlBody
  });

  // 返回空对象，不触发UI弹窗
  return {};
}

注意：需确保插件权限包含https://www.googleapis.com/auth/gmail.compose，否则无法修改草稿内容；图片来源可根据需求调整（如从云端存储获取URL）。

3. 权限验证与测试 #

• 确认oauthScopes已添加gmail.compose权限
• 重新部署插件，在Gmail中测试撰写、回复、转发操作，检查图片是否自动插入

额外优化点 #

• 可通过e.eventMetadata.triggerAction区分触发场景（COMPOSE/REPLY/FORWARD），针对不同场景插入不同图片
• 避免插入过大图片，防止草稿加载异常

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