关于Gmail Java API messages.import接口幂等性的咨询

问题1：自定义Message ID是否能用于幂等性？ #

没错，你手动设置的message.setId(<id>)确实会被Gmail API完全忽略。Gmail系统里的邮件ID（就是你收到的类似14c777cc5fbac1ec的字符串）是由Google服务器唯一生成并分配的，客户端传入的ID字段不会被采纳，也无法用来控制幂等性。API文档里也明确了这一点：Message资源的id属性是只读的，仅由服务端生成。

问题2：API层面是否支持幂等性？ #

很遗憾，gmailImport接口本身并没有内置的幂等机制——重复调用相同参数（哪怕你自己设置了ID）都会创建新的邮件，这就是你测试收件箱出现重复的原因。

所以要避免重复导入，你必须自己实现幂等控制，这里有两个常用的方案：

• 自定义邮件头标记：在要导入的message里添加一个唯一的自定义邮件头，比如X-Import-Unique-ID: <你的GUID>。每次导入前，先调用Gmail的users.messages.list接口，用查询条件header:X-Import-Unique-ID:<你的GUID>搜索目标邮箱，如果返回结果不为空，说明该邮件已经导入过，直接跳过即可。
• 本地记录映射：维护一个本地（或数据库）的记录，存储你生成的GUID和对应的Gmail返回的邮件ID。每次要导入前，先检查这个记录里是否存在该GUID，如果存在就跳过；如果不存在，执行导入后再把GUID和返回的ID存入记录。

这两种方案里，第一种更可靠，因为即使本地记录丢失，也能通过邮件本身的标记来校验重复。

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