在 Gmail API 中使用 'messageListVisibility'

Use of 'messageListVisibility' in Gmail API

我试图根据分配给电子邮件的标签的 'messageListVisibility' 字段来过滤邮件。准确地说,我扫描每封电子邮件的标签,如果任何标签的 messageListVisibility 设置为 "hide",我就不会显示电子邮件。这没有用,所以当我查看调用 "Users.labels: list" 返回的标签时,它检索所有标签,我观察到几件事:

最后一点还算可以,但另外两点有点出人意料。我假设 messageListVisibility 字段的 objective 不向用户显示任何具有该标签的电子邮件是否正确?

您似乎误解了 messageListVisibility 属性的用途。该属性确定 标签名称 是否包含在任何具有此标签的邮件旁边。考虑以下因素:

  • 用户的收件箱中有 5 条消息。每个都应用了 labelA 和 labelB。
  • 标签 A 的 messageListVisibilityhide,标签 B 的 show

当用户单击收件箱并看到这 5 封邮件时,labelB 将在邮件列表中为每封邮件显示,它就在邮件主题的左侧。

documentation describes messageListVisibility 为:

*带有此标签的邮件在 Gmail 网络界面的邮件列表中的可见性。 *