Use Filtros para configurar regras de filtragem avançadas para uma conta. Os filtros podem adicionar ou remover marcadores ou encaminhar e-mails automaticamente para aliases verificados com base nos atributos ou no conteúdo da mensagem recebida.
Para informações sobre como criar, listar, get ou excluir filtros, consulte a Referência de filtros.
Critérios de correspondência
É possível filtrar mensagens por propriedades como remetente, data do assunto, tamanho e conteúdo. Qualquer consulta que use a sintaxe de pesquisa avançada do Gmail também pode ser usada em um filtro. Por exemplo, padrões de filtro comuns incluem:
Filtrar | Correspondências |
---|---|
criteria.from='sender@example.com' |
Todos os e-mails de sender@example.com |
criteria.size=10485760 criteria.sizeComparison='larger' |
Todos os e-mails com mais de 10 MB |
criteria.hasAttachment=true |
Todos os e-mails com um anexo |
criteria.subject='[People with Pets]' |
Todos os e-mails com a string [People with Pets] no assunto |
criteria.query='"my important project"' |
Todos os e-mails contendo a string my important project |
criteria.negatedQuery='"secret knock"' |
Todos os e-mails que não contêm a string secret knock |
Se vários critérios estiverem presentes em um filtro, uma mensagem precisará atender a todos os critérios para que ele seja aplicado.
Ações
Você pode aplicar uma ação a mensagens que correspondam aos critérios do filtro. As mensagens podem ser encaminhadas para um endereço de e-mail verificado ou ter rótulos adicionados ou removidos.
Você pode adicionar ou remover marcadores para alterar a disposição do e-mail. Por exemplo, algumas ações comuns incluem:
Ação | Efeito |
---|---|
action.removeLabelIds=['INBOX'] |
Arquivar o e-mail (ignorar a Caixa de entrada) |
action.removeLabelIds=['UNREAD'] |
Marcar como lida |
action.removeLabelIds=['SPAM'] |
Nunca marcar como spam |
action.removeLabelIds=['IMPORTANT'] |
Nunca marcar como importante |
action.addLabelIds=['IMPORTANT'] |
Marcar como importante |
action.addLabelIds=['TRASH'] |
Excluir o e-mail |
action.addLabelIds=['STARRED'] |
Marcar com estrela |
action.addLabelIds=['<user label id>'] |
Marcar o e-mail com um marcador definido pelo usuário. Somente um rótulo definido pelo usuário é permitido por filtro. |
Exemplos
Veja a seguir um exemplo mais completo que mostra como rotular e arquivar mensagens de uma lista de e-mails.