Sie können Dateien mit den Methoden messages.list und threads.list suchen oder filtern.
Diese Methoden akzeptieren den Parameter q, der einen Großteil der gleichen erweiterten Suchsyntax wie die Gmail-Weboberfläche unterstützt. Eine Liste der Such- und Filterunterschiede 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 Suchanfragen verwenden, um Nachrichten nach Eigenschaften wie Absender, Datum oder Label zu filtern und so verschiedene Möglichkeiten zu nennen. Die folgende Abfrage ruft beispielsweise alle Nachrichten ab, 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
Mit dem Parameter labelIds können Sie nicht nur Suchanfragen, sondern auch Nachrichten und Threads nach Label filtern. Auf diese Weise können Sie nach Nachrichten und Threads mit den angegebenen System- oder Nutzerlabels suchen. Weitere Informationen finden Sie in der Methodenreferenz zu messages.list oder threads.list.
Unterschiede bei Suche und Filtern: Gmail-Benutzeroberfläche und Gmail API im Vergleich
Die Gmail-Benutzeroberfläche führt eine Alias-Erweiterung durch, mit der ein Kontoalias von einem Google Workspace-Konto abgeleitet werden kann. Angenommen, Sie haben ein Konto von
myprimary@mycompany.netund Ihr Administrator richtet für dieses Konto vonmyalias@mycompany.neteinen Alias ein. Wennmyalias@mycompany.neteine E-Mail sendet, Sie aber nach „from: myprimary@mycompany.net)“ suchen, wird die vonmyalias@mycompany.netgesendete E-Mail als Suchergebnis in der Gmail-Benutzeroberfläche, aber nicht in der API-Antwort angezeigt.Über die Gmail-Benutzeroberfläche können Nutzer Thread-weite Suchen ausführen, über die API jedoch nicht.