You need to enable JavaScript to run this app. Gmail API 如何获取SPAM标签邮件的警告横幅文本?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 02:54:04