问：Gmail Api 将来返回带有 InternalDates 的电子邮件

Question

我正在尝试使用 Gmail api 来同步用户 Gmail 收件箱中的所有电子邮件。我正在使用 Gmail 的“同步客户端”[1] 文档中描述的部分同步技术。列出的限制之一是，在极少数情况下，某些电子邮件的 historyId 不可用。在这种情况下，建议客户端重新使用“完全同步”，即客户端应“检索并存储尽可能多的最新消息或线程，以达到您的目的”。

这一切都说得通。当我遇到部分同步问题时，我会尝试按时间范围查看收件箱消息。为此，我有效地存储了我同步的每封电子邮件的( emailAddress, historyId, internalDate ) 的记录，然后当退回到完全同步时，我尝试同步自我已经同步的最新internalDate 以来的所有电子邮件。

我的问题是，似乎导致部分同步失败的案例似乎也导致了完全同步失败，其中许多案例是由internalDates的电子邮件引起的将来（出于隐私原因，我无法分享这些示例）。失败案例好像是这样的

1. 我将电子邮件 E 与 historyId H 和一个 internalDate I 同步
2. 一段时间过去了
3. 我收到来自 google 的推送通知，表明他们是要同步的新电子邮件
4. 我查找我为此收件箱 ID 同步的最新消息，找到电子邮件 E
5. 我尝试使用 listHistory [2] 端点和 historyId H 进行部分同步
6. listHistory 请求失败并返回 404
7. 我尝试使用查询 newer_than:{hours_since-internalDate-I} 使用 listMessages [3] 端点进行完全同步，但此请求没有任何意义，因为此消息的 internalDate 是将来的。

我可以想象一些不同的解决方案来解决这个问题。也许我应该简单地将这些电子邮件视为垃圾邮件，或者我应该存储我同步每封电子邮件的时间戳，然后对我存储的时间戳执行完全同步。

不管怎样，这似乎是 Gmail API 中的一个错误，因为internalDate 应该是 Gmail 收到电子邮件时的真实值。我最初怀疑这可能是由 Gmail 的新日程安排功能引起的，internalDate 可能是将来安排电子邮件的时间，但我确认我的一些示例肯定是针对用户收件箱 收到，而不是发送。真的不知道在internalDate api 中如何处理这个边缘案例。

所以我的问题是，处理虚假未来internalDates 的建议方法是什么？这是一个错误吗？

1. https://developers.google.com/gmail/api/guides/sync
2. https://developers.google.com/gmail/api/v1/reference/users/history/list
3. https://developers.google.com/gmail/api/v1/reference/users/messages/list

Answer 1

如果您确定这是一个错误，您可以前往 Google 的问题跟踪器 (template here) 并报告它，以便他们的工程团队可以查看并查看导致此错误的原因。或者，如果其他邮件或用户仍然存在这种情况，您可以通过转到您的admin dashboard 并在？右上角的菜单。通过这种方式，Google 可以查看错误的 internalDates，而无需您在公共论坛上发布任何潜在的敏感数据。

同时，您可以通过确保您不会获取未来某个时间的邮件（伪代码）来动态解决此问题：

var now = new Date().getTime()
var q = "newer_than:1h before:" + now

GmailServiceConnect.Users.messages.list(userId = "user@domain.ext", q = q).execute()

但请记住，Gmail 使用毫秒来表示 Unix 时间而不是秒，因此必须进行相应调整。