Gmail REST API 获取消息函数返回无效的 historyId

Question

Gmail REST API 中似乎存在严重问题。

1. 调用/userId/messages获取消息列表
2. 对于每个，调用 /userId/messages/id 来获取消息
3. 获取每个消息对象的最高（或任何）startHistoryId
4. 然后调用 /userId/history/list 传递 startHistoryId 作为参数

结果出乎意料。 Gmail REST API 返回 404 Not Found.. 返回的 historyId 似乎未注册或无效。

在调用 /userId/profile 时，startHistoryId 有效，可以在 /userId/history/list 调用中成功使用。

com.google.api.client.googleapis.json.GoogleJsonResponseException: 404 Not Found
{
"code" : 404,
"errors" : [ {
     "domain" : "global",
     "message" : "Not Found",
     "reason" : "notFound"
    } ],
  "message" : "Not Found"
}

Answer 1

这不是 API 中的错误，记录在 https://developers.google.com/gmail/api/v1/reference/users/history/list

特别是“历史 ID 按时间顺序增加，但与有效 ID 之间的随机间隔不连续。提供无效或过期的 startHistoryId 通常会返回 HTTP 404 错误代码。historyId 通常至少在一周内有效，但在某些情况下可能仅在几个小时内有效。如果您收到 HTTP 404 错误响应，您的应用程序应该执行完全同步。"

因此，您可能只是使用了超出存储历史范围的 historyId（它不会无限期存储，这将非常昂贵）。它仅存储足够长的时间以供同步客户端需要它（例如一周左右）。

如果您只需要从某个点向前同步，那么只需使用从 getProfile 返回的 historyId。消息上的 historyId 是消息最后一次更新的时间，可能是几个月或几年前，比历史存储的时间长。

另请参阅同步指南： https://developers.google.com/gmail/api/guides/sync