Nachrichten suchen und filtern

In diesem Dokument wird beschrieben, wie Sie Nachrichten mit der Gmail API abfragen und finden.

Sie können Dateien mit den Methoden messages.list und threads.list suchen oder filtern. Diese Methoden akzeptieren den Abfrageparameter q, der den größten Teil der erweiterten Suchsyntax der 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 zur Gmail-Benutzeroberfläche.

Mit dieser erweiterten Suchsyntax können Sie Nachrichten anhand von Eigenschaften wie Absender, Datum oder Label filtern. Mit der folgenden Abfrage für die Methode messages.list 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 mit den angegebenen System- oder Nutzerlabels suchen. Weitere Informationen finden Sie in den Methoden messages.list und threads.list. Weitere Informationen zu Labels finden Sie unter Labels verwalten.

Unterschiede zur Gmail-Benutzeroberfläche

Die Gmail API unterstützt zwar den Großteil der erweiterten Suchsyntax, die in der Gmail-Benutzeroberfläche verwendet wird, es gibt jedoch einige Unterschiede:

  • In der Gmail-Benutzeroberfläche wird die Alias-Erweiterung ausgeführt, mit der ein Kontoalias aus einem Google Workspace-Konto abgeleitet werden kann. Angenommen, Sie haben ein Konto myprimary@cymbalgroup.com und Ihr Administrator richtet einen Alias für dieses Konto ein: myalias@cymbalgroup.com. Wenn myalias@cymbalgroup.com eine E‑Mail sendet, Sie aber nach „from: myprimary@cymbalgroup.com“ suchen, wird die von myalias@cymbalgroup.com gesendete E‑Mail in den Suchergebnissen in der Gmail-Benutzeroberfläche angezeigt, aber nicht in der API-Antwort.

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