Android中使用Gmail API按邮箱及日期范围获取邮件数据及返回缺日期问题咨询

嘿，我来帮你搞定这两个Gmail API的问题！

Gmail API的查询语法支持多种过滤条件，你可以把发件人邮箱和日期范围组合成一个查询字符串，传给listMessagesMatchingQuery方法。核心是用这几个查询操作符：

• from: 指定目标发件人邮箱
• after: 筛选发送时间晚于指定日期的邮件
• before: 筛选发送时间早于指定日期的邮件

日期格式需要用YYYY/MM/DD，比如要获取2024年1月1日到2月1日之间来自abc@gmail.com的邮件，查询字符串应该是：

from:abc@gmail.com after:2024/01/01 before:2024/02/02

注意：before是“早于”指定日期，所以如果要包含2月1日的邮件，得把结束日期设为2月2日

对应的Java代码示例：

// 定义查询参数
String senderEmail = "abc@gmail.com";
String startDate = "2024/01/01";
String endDate = "2024/02/02";

// 拼接查询字符串
String query = String.format("from:%s after:%s before:%s", senderEmail, startDate, endDate);

// 调用API获取匹配的邮件列表
List<Message> messages = listMessagesMatchingQuery(mService, user, query);

你现在得到的{"id": "...", "threadId": "..."}是Gmail API返回的精简元数据，默认情况下listMessagesMatchingQuery只返回邮件的ID和线程ID，不会包含日期等详细信息。要获取日期，你需要对每个邮件ID单独调用users.messages.get接口，请求完整或元数据格式的邮件内容。

有两种方式获取日期：

方式一：使用internalDate（Gmail内部记录的接收时间） #

internalDate是Gmail服务器记录的邮件接收时间，以毫秒级时间戳返回，解析起来很方便：

for (Message message : messages) {
    // 请求邮件的元数据（比FULL格式更轻量）
    Message fullMessage = mService.users().messages().get(user, message.getId())
            .setFormat("METADATA")
            .execute();
    
    // 获取internalDate并转为Date对象
    long timestamp = fullMessage.getInternalDate();
    Date receiveDate = new Date(timestamp);
    System.out.println("邮件接收时间：" + receiveDate);
}

方式二：从邮件头中提取Date字段（发件方标注的发送时间） #

邮件头里的Date字段是发件人邮件服务器设置的发送时间，格式是RFC 822标准，比如Wed, 10 Jan 2024 14:30:00 +0800，你可以解析这个字符串：

for (Message message : messages) {
    Message fullMessage = mService.users().messages().get(user, message.getId())
            .setFormat("METADATA")
            .setMetadataHeaders(Collections.singletonList("Date")) // 只请求Date头，减少数据量
            .execute();
    
    // 遍历邮件头找Date字段
    List<MessagePartHeader> headers = fullMessage.getPayload().getHeaders();
    for (MessagePartHeader header : headers) {
        if ("Date".equalsIgnoreCase(header.getName())) {
            String dateStr = header.getValue();
            // 解析RFC 822格式的日期字符串
            SimpleDateFormat sdf = new SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss Z", Locale.US);
            try {
                Date sendDate = sdf.parse(dateStr);
                System.out.println("邮件发送时间：" + sendDate);
            } catch (ParseException e) {
                e.printStackTrace();
            }
            break;
        }
    }
}

小提示：如果不需要完整邮件内容，用METADATA格式比FULL更高效，还可以通过setMetadataHeaders指定只获取需要的字段，减少API响应的数据量

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