Procurando mensagens

Você pode 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 da mesma sintaxe de pesquisa avançada da interface da Web do Gmail. Para conferir uma lista das diferenças entre a pesquisa e os filtros da interface do Gmail e da API Gmail, consulte Diferenças entre os filtros de pesquisa: interface do Gmail x API Gmail.

Com essa sintaxe avançada, é possível usar consultas de pesquisa para filtrar mensagens por propriedades como remetente, data ou marcador, entre outras 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 no fuso horário do Pacífico (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, você também pode filtrar mensagens e conversas por marcador com o parâmetro labelIds. Assim, você pode pesquisar mensagens e conversas com os marcadores especificados do sistema ou do usuário. Para mais informações, consulte a referência do método messages.list ou threads.list.

Diferenças entre pesquisa e filtros: interface do Gmail x API Gmail

• A interface do Gmail realiza a expansão de alias, o 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 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 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 conversa, mas a API não.