Wyszukiwanie wiadomości

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

Ostrzeżenie: wszystkie daty użyte w zapytaniu są interpretowane jako północ danego dnia w strefie czasowej PST. Aby określić dokładne daty dla innych stref czasowych, zamiast tego przekaż wartość w sekundach:

?q=in:sent after:1388552400 before:1391230800

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 [e-mail], a Twój administrator skonfigurował alias dla tego konta [e-mail]. jeśli [e-mail] wyśle e-maila, ale wyszukasz „from: [e-mail])”, to e-mail wysłany przez [e-mail] 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.