Nach Nachrichten suchen

Sie können Dateien mit den Methoden messages.list und threads.list suchen oder filtern. Diese Methoden akzeptieren den Parameter q, der die meisten derselben Syntaxelemente für die erweiterte Suche unterstützt wie die Gmail-Weboberfläche. Eine Liste der Unterschiede bei Such- und Filterfunktionen zwischen der Gmail-Benutzeroberfläche und der Gmail API finden Sie unter Unterschiede bei Suchfiltern: Gmail-Benutzeroberfläche und Gmail API.

Mit dieser erweiterten Syntax können Sie Nachrichten mithilfe von Suchanfragen nach Eigenschaften wie Absender, Datum oder Label filtern. Mit der folgenden Abfrage werden beispielsweise alle Nachrichten abgerufen, die der Nutzer im Januar 2014 gesendet hat:

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

Zusätzlich zu Suchanfragen können Sie Nachrichten und Threads mit dem Parameter labelIds auch nach Label filtern. So können Sie nach Nachrichten und Unterhaltungen mit den angegebenen System- oder Nutzerlabels suchen. Weitere Informationen finden Sie in der Methodenreferenz zu messages.list oder threads.list.

Unterschiede bei der Suche und beim Filtern: Gmail-Benutzeroberfläche und Gmail API

  • Die Gmail-Benutzeroberfläche führt eine Aliaserweiterung durch, mit der ein Kontoalias aus einem Google Workspace-Konto abgeleitet werden kann. Angenommen, Sie haben das Konto myprimary@mycompany.net und Ihr Administrator richtet für dieses Konto den Alias myalias@mycompany.net ein. Wenn myalias@mycompany.net eine E-Mail sendet, Sie aber nach „from: myprimary@mycompany.net)“ suchen, wird die von myalias@mycompany.net gesendete E-Mail in der Gmail-Benutzeroberfläche als Suchergebnis angezeigt, aber nicht in der API-Antwort.

  • Über die Gmail-Benutzeroberfläche können Nutzer forenweite Suchanfragen durchführen, über die API jedoch nicht.