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, consulta Differenze tra i filtri di ricerca: interfaccia utente di Gmail e API Gmail.

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

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

Avviso: tutte le date utilizzate nella query di ricerca vengono interpretate come mezzanotte della data in questione nel fuso orario PST. Per specificare date precise per altri fusi orari, passa il valore in secondi:

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

Oltre alle query di ricerca, puoi anche filtrare i messaggi e i thread in base all'etichetta con il parametro labelIds. In questo modo puoi cercare messaggi e discussioni con le etichette di sistema o utente specificate. Per ulteriori informazioni, consulta il riferimento al metodo messages.list o threads.list.

Differenze tra ricerca e filtri: interfaccia utente di Gmail e API Gmail

• L'interfaccia utente di Gmail esegue l'espansione degli alias, che consente di dedurre un alias account da un account Google Workspace. Ad esempio, supponiamo che tu abbia un account [e-mail] e che l'amministratore configuri un alias per quell'account [e-mail]. Se [e-mail] invia un'email, ma cerchi "from: [e-mail])", l'email inviata da [e-mail] 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 no.