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 oferece suporte à maioria da mesma sintaxe de pesquisa avançada da interface da Web do Gmail. Para uma lista de diferenças de pesquisa e filtro entre a interface do Gmail e a API Gmail, consulte Diferenças de filtro de pesquisa: interface do Gmail x API Gmail.

Essa sintaxe avançada permite usar consultas de pesquisa para filtrar mensagens por propriedades, como remetente, data ou rótulo, para citar 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 naquela data no fuso horário do Pacífico. 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, você também pode filtrar mensagens e linhas de conversa por marcador com o parâmetro labelIds. Isso permite pesquisar mensagens e linhas de transmissão com os rótulos do sistema ou do usuário especificados. Para mais informações, consulte a referência do método messages.list ou threads.list.

Diferenças entre a pesquisa e o filtro: interface do Gmail e API Gmail

• A interface do Gmail realiza a expansão de alias, o que permite inferir um alias de uma conta do Google Workspace. Por exemplo, suponha que você tenha uma conta [e-mail] e o administrador configure 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] vai aparecer como um resultado de pesquisa na interface do Gmail, mas não na resposta da API.

• A interface do Gmail permite que os usuários realizem pesquisas em toda a linha de execução, mas a API não.