É possível pesquisar ou filtrar arquivos usando os métodos
messages.list
e
threads.list
.
Esses métodos aceitam o parâmetro q
, que é compatível com a maioria das mesmas sintaxe de pesquisa avançada que a interface da Web do Gmail. Para conferir uma lista das diferenças entre
a interface do Gmail e a API Gmail, consulte
Diferenças dos filtros de pesquisa: interface do Gmail versus API Gmail.
Com essa sintaxe avançada, é possível usar consultas de pesquisa para filtrar mensagens por propriedade, como remetente, data ou rótulo, para nomear algumas possibilidades. Por exemplo, a consulta a seguir recupera todas as mensagens enviadas pelo usuário em janeiro de 2014:
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
Além das consultas de pesquisa, também é possível filtrar mensagens e conversas por rótulo
com o parâmetro labelIds
. Isso permite que você pesquise mensagens e conversas com o sistema especificado ou os marcadores de usuário aplicados. Para mais informações,
consulte a referência do método messages.list
ou
threads.list
.
Diferenças de pesquisa e filtro: interface do Gmail ou API Gmail
Na IU do Gmail, é feita a expansão de alias, que permite inferir um alias de conta de uma conta do Google Workspace. Por exemplo, suponha que você tenha uma conta de
myprimary@mycompany.net
e seu administrador tenha configurado um alias para essa conta demyalias@mycompany.net
. Semyalias@mycompany.net
enviar um e-mail, mas você pesquisar "from: myprimary@mycompany.net)
", o e-mail enviado pormyalias@mycompany.net
aparecerá como resultado da pesquisa na interface do Gmail, mas não na resposta da API.A interface do Gmail permite que os usuários façam pesquisas em toda a linha de execução, mas a API não.