Pliki możesz wyszukiwać i filtrować, korzystając z metod messages.list
i threads.list
.
Te metody akceptują parametr q
, który obsługuje większość tej samej składni wyszukiwania zaawansowanego co interfejs internetowy Gmaila. Listę różnic w wyszukiwaniu i filtrowaniu między interfejsem Gmaila a interfejsem Gmail API znajdziesz w artykule Różnice w filtrach wyszukiwania: interfejs Gmaila a interfejs Gmail API.
Ta zaawansowana składnia umożliwia filtrowanie wiadomości według właściwości, takich jak nadawca, data lub etykieta, za pomocą zapytań. Na przykład to zapytanie pobiera wszystkie wiadomości wysłane przez użytkownika w styczniu 2014 r.:
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
Oprócz zapytań możesz też filtrować wiadomości i wątki według etykiety za pomocą parametru labelIds
. Umożliwia to wyszukiwanie wiadomości i wątków z zastosowanymi określonymi etykietami systemowymi lub użytkownika. Więcej informacji znajdziesz w dokumentacji metody messages.list
lub threads.list
.
Różnice w wyszukiwaniu i filtrach: interfejs użytkownika Gmaila a interfejs Gmail API
Interfejs Gmaila obsługuje rozwinięcie aliasu, co umożliwia wywnioskowanie aliasu konta z konta Google Workspace. Załóżmy na przykład, że masz konto
myprimary@mycompany.net
, a Twój administrator skonfigurował alias dla tego kontamyalias@mycompany.net
. jeślimyalias@mycompany.net
wyśle e-maila, ale wyszukasz „from: myprimary@mycompany.net)
”, to e-mail wysłany przezmyalias@mycompany.net
wyświetli się w wynikach wyszukiwania w interfejsie Gmaila, ale nie w odpowiedzi interfejsu API.Interfejs Gmaila pozwala użytkownikom wyszukiwać w całym wątku, ale interfejs API już nie.