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: l'interfaccia utente di Gmail e l'API Gmail.

Questa sintassi avanzata ti consente di usare le query di ricerca per filtrare i messaggi in base a proprietà come mittente, data o etichetta per indicare alcune possibilità. 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 di quella data nel fuso orario PST. Per specificare date precise per altri fusi orari, trasferisci il valore in secondi:

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

Oltre alle query di ricerca, puoi anche filtrare i messaggi e i thread per etichetta con il parametro labelIds. Ciò consente di cercare messaggi e thread con le etichette utente o di sistema specificate. Per saperne di più, consulta la sezione di riferimento al metodo messages.list o threads.list.

Differenze di ricerca e filtro: l'interfaccia utente di Gmail e l'API Gmail

• La UI di Gmail esegue l'espansione dell'alias, che consente di dedurre un alias account da un account Google Workspace. Ad esempio, supponi di avere un account di [e-mail] e che l'amministratore abbia configurato un alias per questo account di [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.

• La UI di Gmail consente agli utenti di eseguire ricerche a livello di thread, ma non l'API.