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 avanzata della Ricerca dell'interfaccia web di Gmail. Per un elenco delle differenze tra i filtri di ricerca e quelli tra l'interfaccia utente di Gmail e l'API Gmail, vedi Differenze tra i filtri di ricerca: interfaccia di Gmail e API di Gmail.
Questa sintassi avanzata consente di utilizzare le 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 a 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 per etichetta con il parametro labelIds. Questo consente di cercare i messaggi e i thread con le etichette utente o di sistema specificate applicate. Per ulteriori informazioni, consulta i riferimenti al metodo messages.list o threads.list.
Differenze tra ricerca e filtri: interfaccia utente di Gmail e API di Gmail
L'interfaccia utente di Gmail esegue l'espansione alias, che consente di dedurre un alias account da un account Google Workspace. Ad esempio, supponiamo che il tuo account sia
myprimary@mycompany.nete che l'amministratore configuri un alias per quell'accountmyalias@mycompany.net. Semyalias@mycompany.netinvia un'email, ma cerchi "from: myprimary@mycompany.net)", l'email inviata damyalias@mycompany.netviene visualizzata come risultato di ricerca nella UI di Gmail, ma non nella risposta dell'API.A differenza dell'API, l'interfaccia utente di Gmail consente agli utenti di eseguire ricerche a livello di thread.