Procurando mensagens

É 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

Aviso :todas as datas usadas na consulta de pesquisa são interpretadas como meia-noite dessa data no fuso horário PST. Para especificar datas precisas para outros fusos horários, transmita o valor em segundos:

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

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 [e-mail] e seu administrador tenha configurado um alias para essa conta de [e-mail]. Se [e-mail] enviar um e-mail, mas você pesquisar "from: [e-mail])", o e-mail enviado por [e-mail] 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.