如何通过Gmail API获取CHAT标签消息的收件人信息？

我之前帮不少开发者处理过这个问题，Gmail API对Chat消息的处理逻辑确实和普通邮件有区别——单条Chat消息的payload.headers里确实不会返回To这类收件人字段，因为Chat是基于**线程（Thread）**的对话模式，参与者信息被存在线程层级里，而不是单条消息的头信息中。

下面给你两个可行的解决思路：

方法一：直接获取线程（Thread）信息 #

因为Chat消息属于一个对话线程，你可以通过单条Chat消息的threadId调用users.threads.get接口，线程对象里的participants字段会列出所有参与该Chat的用户，其中就包含你要找的收件人。

示例请求 #

GET https://gmail.googleapis.com/gmail/v1/users/me/threads/{threadId}?format=full

关键返回字段示例 #

{
  "id": "xxxx",
  "snippet": "asdfasdfasdf",
  "historyId": "171386",
  "participants": [
    {
      "emailAddress": "admin@xxx.com"
    },
    {
      "emailAddress": "userb@xxx.com"
    }
  ],
  "messages": [/* 包含线程内的所有消息 */]
}

你可以从participants里排除自己的邮箱，剩下的就是Chat的收件人。

方法二：通过消息ID关联线程并获取参与者 #

如果你是先拿到了单条Chat消息的ID，也可以按以下步骤操作：

1. 调用users.messages.get获取消息的基础信息，从中提取threadId
2. 用拿到的threadId调用users.threads.get，提取participants字段获取所有参与者

另外要注意，调用API时尽量使用format=full或者format=metadata并指定metadataHeaders包含X-GM-THRID（用来快速获取线程ID），这样能减少不必要的数据传输。

补充说明：Gmail Chat的消息结构设计和普通邮件不同，普通邮件的To头是明确的收件人列表，但Chat是多参与者的对话线程，所以API把参与者信息统一放在线程层面，这也是为什么单条消息的头里找不到收件人信息的原因。

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