Ricerca di messaggi

Puoi cercare o filtrare i file utilizzando i metodi messages.list e threads.list. Questi metodi accettano il parametro q, che supporta la maggior parte della stessa sintassi di ricerca avanzata dell'interfaccia web di Gmail. Per un elenco delle differenze di ricerca e filtro tra l'interfaccia utente di Gmail e l'API Gmail, vedi Differenze tra i filtri di ricerca: interfaccia utente di Gmail e API Gmail.

Questa sintassi avanzata ti consente di utilizzare query di ricerca per filtrare i messaggi in base a proprietà quali mittente, data o etichetta, per citare alcune possibilità. Ad esempio, la seguente query recupera tutti i messaggi inviati dall'utente nel gennaio 2014:

GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01

Oltre alle query di ricerca, puoi anche filtrare messaggi e thread in base all'etichetta con il parametro labelIds. In questo modo, puoi cercare messaggi e thread a cui sono state applicate le etichette di sistema o utente specificate. Per ulteriori informazioni, consulta il messages.list o threads.list.

Differenze tra ricerca e filtri: UI di Gmail e API Gmail

  • L'interfaccia utente di Gmail esegue l'espansione degli alias, che consente di dedurre un alias dell'account da un account Google Workspace. Ad esempio, supponiamo che tu abbia un account di myprimary@mycompany.net e che il tuo amministratore configuri un alias per questo account di myalias@mycompany.net. Se myalias@mycompany.net invia un'email, ma cerchi "from: myprimary@mycompany.net)", l'email inviata da myalias@mycompany.net viene visualizzata come risultato di ricerca nell'interfaccia utente di Gmail, ma non nella risposta dell'API.

  • L'interfaccia utente di Gmail consente agli utenti di eseguire ricerche a livello di thread, ma l'API non lo fa.