如何通过Gmail API举报垃圾邮件？添加SPAM标签是否等效？

• 举报垃圾邮件的官方API方法：使用Gmail API提供的users.messages.reportSpam接口，这和Gmail UI里的「举报为垃圾邮件」功能完全等效。调用该接口后，不仅会将目标邮件标记为垃圾邮件并移至垃圾邮件文件夹，还会自动向Google提交该邮件的相关信息，用于优化全局垃圾邮件过滤规则。

  示例代码（Python）：

  from googleapiclient.discovery import build
  
  # 假设已完成OAuth2认证，得到credentials对象
  gmail_service = build('gmail', 'v1', credentials=credentials)
  # 举报指定邮件（userId为'me'代表当前认证用户）
  gmail_service.users().messages().reportSpam(
      userId='me',
      id='目标邮件的ID'
  ).execute()
  

• 添加SPAM标签的效果差异：单纯通过users.messages.modify接口为邮件添加系统标签Label_10（Gmail中SPAM标签的固定ID），仅能将邮件移至垃圾邮件文件夹，但不会触发向Google提交举报信息的流程。这种操作更像是手动将邮件归类为垃圾，而非「举报」行为，和UI里的功能效果不完全一致。

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