Wyszukiwanie i filtrowanie wiadomości

Z tego dokumentu dowiesz się, jak wysyłać zapytania i znajdować wiadomości za pomocą interfejsu Gmail API.

Możesz wyszukiwać i filtrować pliki za pomocą metod messages.list i threads.list. Te metody akceptują parametr zapytania q, który obsługuje większość zaawansowanej składni wyszukiwania, tak jak interfejs Gmaila w przeglądarce. Listę różnic w wyszukiwaniu i filtrowaniu między interfejsem Gmaila a interfejsem Gmail API znajdziesz w sekcji Różnice w porównaniu z interfejsem Gmaila.

Ta składnia wyszukiwania zaawansowanego umożliwia filtrowanie wiadomości według właściwości, takich jak nadawca, data czy etykieta. Na przykład to zapytanie metody messages.list 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 określonymi etykietami systemowymi lub etykietami użytkownika. Więcej informacji znajdziesz w sekcjach dotyczących metod messages.list i threads.list. Więcej informacji o etykietach znajdziesz w artykule Zarządzanie etykietami.

Różnice w interfejsie Gmaila

Interfejs Gmail API obsługuje większość składni wyszukiwania zaawansowanego używanej w interfejsie Gmaila, ale występują pewne różnice:

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

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