正在搜索邮件

您可以使用 messages.listthreads.list 方法搜索或过滤文件。这些方法接受 q 参数,该参数支持与 Gmail 网页界面相同的大多数高级搜索语法。如需查看 Gmail 界面和 Gmail API 在搜索和过滤方面的差异列表,请参阅搜索过滤条件差异:Gmail 界面与 Gmail API

借助此高级语法,您可以使用搜索查询按发件人、日期或标签等属性过滤消息,从而仅提供一些可能的信息。例如,以下查询会检索用户在 2014 年 1 月发送的所有消息:

GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01

除了搜索查询之外,您还可以使用 labelIds 参数按标签过滤消息和会话。这样,您就可以搜索应用了指定系统或用户标签的消息和会话。如需了解详情,请参阅 messages.listthreads.list 方法参考文档。

搜索和过滤方面的差异:Gmail 界面与 Gmail API

  • Gmail 界面会执行别名扩展,使其能够根据 Google Workspace 帐号推断出帐号别名。例如,假设您有一个 myprimary@mycompany.net 帐号,并且您的管理员为该帐号 myalias@mycompany.net 设置了别名。如果 myalias@mycompany.net 发送了一封电子邮件,但您搜索“from: myprimary@mycompany.net)”,那么 myalias@mycompany.net 发送的电子邮件会在 Gmail 界面中显示为搜索结果,但不会在 API 响应中显示。

  • 在 Gmail 界面中,用户可以执行会话级搜索,但 API 不允许。