使用GCP Pub/Sub接收Gmail通知时，如何获取邮件主题与内容？

你遇到的404错误核心原因是：Pub/Sub消息的message.id是Pub/Sub自身的消息标识，并非Gmail邮件的ID。要获取邮件主题、内容，需要先解析Pub/Sub消息的data字段，从中提取真实的Gmail邮件ID，再调用Gmail API。

具体修正步骤 #

1. 解码Pub/Sub消息数据
   Gmail通过Pub/Sub推送的消息是Base64编码的JSON字符串，需要先解码解析：

const messageData = JSON.parse(Buffer.from(message.data, 'base64').toString());

2. 提取Gmail邮件ID
   解码后的JSON里会包含messages数组（新增邮件时），里面的id才是真实的Gmail邮件ID：

// 新增邮件时，messages数组会包含该邮件的信息
if (messageData.messages && messageData.messages.length > 0) {
  const gmailMessageId = messageData.messages[0].id;
  // 用这个ID调用Gmail API
  const m = await google.gmail("v1").users.messages.get({ 
    id: gmailMessageId, 
    userId: 'me', 
    format: 'full' 
  });
  console.log('邮件详情:', m.data);
}

3. 修正后的完整messageHandler代码

const messageHandler = async message => {
  console.log(`Received Pub/Sub message ${message.id}:`);
  
  // 解码并解析Gmail事件数据
  const messageData = JSON.parse(Buffer.from(message.data, 'base64').toString());
  console.log('Gmail事件数据:', messageData);

  // 仅处理新增邮件的事件
  if (messageData.messages && messageData.messages.length > 0) {
    const gmailMessageId = messageData.messages[0].id;
    try {
      const m = await google.gmail("v1").users.messages.get({ 
        id: gmailMessageId, 
        userId: 'me', 
        format: 'full' 
      });
      console.log('邮件主题:', m.data.payload.headers.find(h => h.name === 'Subject').value);
      // 如需获取邮件内容，可解析m.data.payload.body或parts
    } catch (apiError) {
      console.error('调用Gmail API失败:', apiError);
    }
  }

  messageCount += 1;
  message.ack();
};

额外注意事项 #

• 启用Gmail API：确保在GCP控制台已启用Gmail API
• 权限配置：运行代码的服务账号需要拥有Gmail Readonly权限（或更细粒度的邮件读取权限）
• 事件类型判断：Gmail的watch事件不仅包含新增邮件，还可能有标签变更等操作，可通过messageData.historyId结合users.history.list接口获取完整事件详情

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