Gmail API users.watch无法监听网页端发送邮件的问题及解决方法

原因 #

Gmail网页端发送邮件时，SENT标签是在邮件创建的同时直接附加的，而你设置的labelIds: ['SENT']监听的是「标签被添加到已有邮件」的事件——这种创建时直接打标签的操作不会触发watch的推送通知。而回复邮件时，新邮件会先进入INBOX，触发INBOX相关的标签变更事件，所以你能收到通知。

解决方法 #

放弃通过labelIds监听SENT标签的方式，改为监听全量历史变更，再在后续接口调用中筛选已发送邮件：

1. 调整watch请求代码 #

移除labelIds参数（或保留INBOX等其他标签，但要补充全量监听逻辑），让watch监听所有账号内的历史变更：

const watchResponse = (
    await gmail.users.watch({
        userId: 'me',
        requestBody: { topicName }, // 移除labelIds，监听全量历史
    })
).data;
userData.currentHistoryId = watchResponse.historyId;
userData.watchExpTime = new Date(Number(watchResponse.expiration));

2. 收到推送后的处理逻辑 #

当收到推送通知时，调用users.history.list接口，传入上次保存的currentHistoryId，遍历返回的历史记录：

• 筛选出historyType为messageAdded的记录
• 对每条新增邮件，调用users.messages.get接口，检查邮件的labelIds是否包含SENT标签
• 确认是已发送邮件后，执行你的业务逻辑

这样就能准确捕获到网页端发送的邮件事件了。

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