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 Syntax für die erweiterte Suche wie die Gmail-Weboberfläche unterstützt. Eine Liste der Unterschiede bei der Suche und beim Filtern zwischen der Gmail-Benutzeroberfläche und der Gmail API finden Sie unter Unterschiede bei Suchfiltern: Gmail-Benutzeroberfläche im Vergleich zur Gmail API.

Mit dieser erweiterten Syntax können Sie Nachrichten anhand von 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 auch mit dem Parameter labelIds nach Label filtern. So können Sie nach Nachrichten und Unterhaltungen suchen, auf die die angegebenen System- oder Nutzerlabels angewendet wurden. Weitere Informationen finden Sie in der Referenz zur Methode messages.list oder threads.list.

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

  • Die Gmail-Benutzeroberfläche führt eine Alias-Erweiterung durch, mit der ein Kontoalias aus einem Google Workspace-Konto abgeleitet werden kann. Angenommen, Sie haben ein Konto myprimary@mycompany.net und Ihr Administrator richtet einen Alias für dieses Konto ein: myalias@mycompany.net. 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, nicht aber in der API-Antwort.

  • In der Gmail-Benutzeroberfläche können Nutzer threadweite Suchvorgänge ausführen, in der API jedoch nicht.