Pliki możesz wyszukiwać lub filtrować za pomocą metod messages.list i threads.list.
Te metody akceptują parametr q, który obsługuje większość tych samych zaawansowanych elementów składni wyszukiwania co interfejs internetowy Gmaila. Listę różnic między wyszukiwaniem i filtrowaniem w interfejsie Gmaila a interfejsem Gmail API znajdziesz w artykule Różnice między wyszukiwaniem i filtrowaniem w interfejsie Gmaila a interfejsem Gmail API.
Ta zaawansowana składnia umożliwia korzystanie z zapytań wyszukiwania do filtrowania wiadomości według właściwości, takich jak nadawca, data czy etykieta. Na przykład to zapytanie zwraca wszystkie wiadomości wysłane przez użytkownika w styczniu 2014 roku:
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
Oprócz zapytań wyszukiwania możesz też filtrować wiadomości i wątki według etykiety za pomocą parametru labelIds. Dzięki temu możesz wyszukiwać wiadomości i wątki z określonymi etykietami systemowymi lub użytkownika. Więcej informacji znajdziesz w opisie metody messages.list lub threads.list.
Różnice między wyszukiwaniem a filtrowaniem: interfejs Gmaila a interfejs Gmail API
Interfejs Gmaila wykonuje rozszerzenie aliasu, które pozwala mu wywnioskować alias konta z konta Google Workspace. Załóżmy na przykład, że masz konto
myprimary@mycompany.net, a administrator skonfigurował dla niego aliasmyalias@mycompany.net. Jeślimyalias@mycompany.netwysyła e-maila, ale Ty wyszukujesz „from: myprimary@mycompany.net)”, e-mail wysłany przezmyalias@mycompany.netpojawi się jako wynik wyszukiwania w interfejsie Gmaila, ale nie w odpowiedzi interfejsu API.Interfejs Gmaila umożliwia użytkownikom wyszukiwanie w całym wątku, ale interfejs API nie.