Wyszukiwanie wiadomości

Możesz wyszukiwać i filtrować pliki, korzystając z metod messages.list i threads.list. Te metody akceptują parametr q, który obsługuje większość zaawansowanej składni wyszukiwania, podobnie jak 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 używanie zapytań do filtrowania wiadomości według właściwości, takich jak nadawca, data czy etykieta. Na przykład to zapytanie pobiera 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ń 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 etykietami użytkownika. Więcej informacji znajdziesz w dokumentacji metody messages.list lub threads.list.

Różnice w wyszukiwaniu i filtrowaniu: interfejs Gmaila a interfejs Gmail API

  • Interfejs Gmaila wykonuje rozwijanie aliasu, co pozwala mu wywnioskować alias konta z konta Google Workspace. Załóżmy na przykład, że masz konto myprimary@mycompany.net, a administrator skonfiguruje dla niego alias myalias@mycompany.net. Jeśli myalias@mycompany.net wyśle e-maila, ale wyszukasz „from: myprimary@mycompany.net)”, e-mail wysłany przez myalias@mycompany.net pojawi się jako wynik wyszukiwania w interfejsie Gmaila, ale nie w odpowiedzi interfejsu API.

  • Interfejs Gmaila umożliwia użytkownikom wyszukiwanie w wątkach, ale interfejs API nie.