在 Gmail Addon 上获取草稿正文

Question

我有一个与此类似的问题 Question 并且该主题错误已经解决，但我需要从用户正在编写的消息中获取“正文”以及“messageId”。

我有一个 contextualTrigger，但它没有登录 STACKDRIVER

function onGmailMessageOpen(e) {
  console.log(e);
  
  // Get the ID of the message the user has open.
  var messageId = e.gmail.messageId;
}

"gmail": {
      "contextualTriggers": [
        {
          "unconditional": {},
          "onTriggerFunction": "onGmailMessageOpen"
        }
      ],

有没有办法获取当前撰写消息的“body”和“messageId”，无论是新草稿还是回复，还是插件的限制？

Answer 1

TL;DR

您正在将两个不同的触发器合二为一。
编写 UI 事件对象没有 body 字段。
撰写 UI 事件对象不应有 subject 字段（但有）。

这不是错误

这种行为是在组合 UI 的上下文中触发的触发器的事件对象应该如何工作。在文档中，没有提及 subject 或 body 字段（尽管 subject 现在可用 事实上 ，可能是由于您引用的问答中提到的功能请求）。

事件对象结构

目前gmail资源只能有the following properties:

| Property      | Type     | Always present?     |
| ------------- | -------- | ------------------- |
| accessToken   | string   | Yes                 |
| bccRecipients | string[] | disabled by default |
| ccRecipients  | string[] | disabled by default |
| messageId     | string   | Yes                 |
| threadId      | string   | Yes                 |
| toRecipients  | string[] | disabled by default |

但是，此事件对象结构 特定于消息 UI，并且未在撰写 UI 上下文中完整构造。

编写UI事件对象

composeTrigger 清单字段中指定的撰写 UI 触发器无权访问打开的消息元数据。鉴于 METADATA 范围存在，the event object 看起来像这样（如果 subject 为空，资源中将缺少它）：

{
  commonEventObject: {
    platform: 'WEB',
    hostApp: 'GMAIL'
  },
  gmail: {
    subject: '12345'
  },
  clientPlatform: 'web',
  draftMetadata: {
    toRecipients: [],
    subject: '12345',
    bccRecipients: [],
    ccRecipients: []
  },
  hostApp: 'gmail'
}

现在，尝试构建一个 Card and add an actionable widget to it (i.e. a TextButton):

const onComposeAction = (e) => {
    const builder = CardService.newCardBuilder();

    const section = CardService.newCardSection();

    const action = CardService.newAction();
    action.setFunctionName("handleButtonClick"); //<-- callback name to test event object;
    
    const widget = CardService.newTextButton();
    widget.setText("Test Event Object");
    widget.setOnClickAction(action);

    section.addWidget(widget);

    builder.addSection(section);

    return builder.build();
};

触发动作后，如果您记录事件对象，您会发现它看起来与前一个非常相似，并附加了动作事件对象属性：

{
  hostApp: 'gmail',
  formInputs: {}, //<-- multi-value inputs
  formInput: {}, //<-- single-value inputs
  draftMetadata: {
    subject: '12345',
    ccRecipients: [],
    toRecipients: [],
    bccRecipients: []
  },
  gmail: {
    subject: '12345'
  },
  parameters: {}, //<-- parameters passed to builder
  clientPlatform: 'web',
  commonEventObject: {
    hostApp: 'GMAIL',
    platform: 'WEB'
  }
}

请注意缺少 accessToken、threadId 和 messageId 属性 - 触发器在当前打开的草稿而不是打开的电子邮件的上下文中触发。

消息UI事件对象

相反，消息 UI 事件对象（为响应 在阅读模式下打开电子邮件 而构造的对象，并传递给 onTriggerFunction 清单属性) 确实包含必要的元数据：

{
  messageMetadata: {
    accessToken: 'token here',
    threadId: 'thread id here',
    messageId: 'message id here'
  },
  clientPlatform: 'web',
  gmail: {
    messageId: 'message id here',
    threadId: 'thread id here',
    accessToken: 'token here'
  },
  commonEventObject: {
    platform: 'WEB',
    hostApp: 'GMAIL'
  },
  hostApp: 'gmail'
}

解决方法

一个可行的解决方法是使用 getDraftMessages 方法并提取第一个匹配的草稿（合理假设在此期间不会创建草稿的完整副本）。这种实用程序的一个例子是：

const listDraftGmailMessages = ({
    subject,
    toRecipients: to,
    ccRecipients: cc,
    bccRecipients: bcc
} = {}) => {

    const drafts = GmailApp.getDraftMessages();

    return drafts.filter((draft) => {
        const s = draft.getSubject();
        const t = draft.getTo().split(",");
        const c = draft.getCc().split(",");
        const b = draft.getBcc().split(",");

        const sameSubj = subject ? s === subject : true;
        const sameTo = to ? t.every(r => to.includes(trimFrom(r))) : true;
        const sameCc = cc ? c.every(r => cc.includes(trimFrom(r))) : true;
        const sameBcc = bcc ? b.every(r => bcc.includes(trimFrom(r))) : true;

        return sameSubj && sameTo && sameCc && sameBcc;
    });
};

注意getTo, getCc and getBcc所有return个收件人都是name <email>的形式，所以要剪掉。一个“足够好”的实用程序 trimFrom 应该可以解决问题：

const trimFrom = (input) => {
    try {
        const regex = /<([-\w.]+@\w+(?:\.\w+)+)>/i;
        const [, email] = input.match(regex) || [input];
        return email || input;
    } catch (error) {
        console.warn(error);
        return input;
    }
};

提取第一个匹配草稿后，您可以随意使用它（您的情况，使用getBody方法）。

在 Gmail Addon 上获取草稿正文

Getting draft body on Gmail Addon

gmail

triggers

add-on

google-apps-script