Gmail API 如何获取SPAM标签邮件的警告横幅文本?
Gmail SPAM判定横幅内容的获取实现方案
官方Gmail API的原生可获取字段
- 网页端展示的SPAM判定横幅内容,本质是从邮件传输过程中附带的自定义邮件头渲染生成,完全可以通过官方API直接提取,不需要依赖Selenium爬取
- 调用
users.messages.get单邮件获取接口时,通过指定参数定向拉取关联邮件头,即可拿到和横幅完全一致的文本内容:X-Gmail-Spam-Reason:存储SPAM标记的核心判定原因,是横幅的主体文本来源,对应普通提醒类灰色横幅的核心内容X-Spam-Score:存储该邮件的垃圾邮件评分,对应灰色横幅中附带的评分说明部分X-Spam-Status:存储强拦截类判定结果,对应高风险提示类红色横幅的展示内容
- 调用时需在参数中设置
format=metadata,并把上述字段名加入metadataHeaders列表,避免无意义拉取全量邮件正文,降低接口调用耗时
批量拉取的实现路径
- 先通过
users.messages.list接口,过滤出所有带SPAM标签的邮件ID列表 - 循环遍历邮件ID列表,逐个调用单邮件获取接口提取上述自定义头字段,汇总后即可拿到所有垃圾邮件对应的横幅文本
- 该方案的整体性能、稳定性远高于Selenium页面爬取,不存在页面结构变动导致的脚本失效问题
边界说明
- 如果某封邮件未触发Gmail完整的垃圾邮件扫描流程,上述自定义头可能不存在,此时网页端也不会展示详细的判定原因横幅,API返回结果会和前端表现完全对齐
- 不要尝试从标签属性中读取判定原因,标签本身仅存储“被标记为SPAM”这个动作,不会存储标记背后的具体逻辑
极简Python调用示例
from googleapiclient.discovery import build def fetch_spam_banner_text(service, message_id): result = service.users().messages().get( userId="me", id=message_id, format="metadata", metadataHeaders=["X-Gmail-Spam-Reason", "X-Spam-Score", "X-Spam-Status"] ).execute() # 遍历邮件头匹配目标字段 header_map = {item["name"]: item["value"] for item in result["payload"]["headers"]} # 组装和前端展示一致的横幅文本 banner_parts = [] if reason := header_map.get("X-Gmail-Spam-Reason"): banner_parts.append(reason) if score := header_map.get("X-Spam-Score"): banner_parts.append(f"垃圾邮件评分: {score}") return " ".join(banner_parts)
注意:部分第三方邮件服务商发件时会屏蔽这类自定义头信息,这种场景下无论前端展示还是API拉取,都无法获取到具体的判定原因文本
内容的提问来源于stack exchange,提问作者JCDeveloper
相关产品推荐
相关产品推荐

