Um Google Apps Script que aplica marcadores, arquiva e organiza o seu Gmail com regras que os filtros comuns não conseguem

Exemplo de resultado

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Pasta: sales/2026-10, 9 arquivos encontrados
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 linhas
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 linhas
2026-11-02 09:14:04 WARN  shop-07.csv: 3 linhas sem preço ignoradas (linhas 88, 412, 913)
2026-11-02 09:14:05 INFO  Pronto: 10.412 linhas -> report-2026-10.xlsx (abas "Vendas" e "Totais")

[columns]
date = Data, Data da venda, Dia
product = Produto, Item, Descrição
quantity = Qtd, Quantidade, Unid
price = Preço, Preço unitário

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lê o arquivo de uma loja e dá a ele os nomes de colunas do relatório."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: nenhuma coluna para '{name}' (procuradas: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Sobre este serviço

Os filtros do Gmail só agem em e-mails novos e só por condições simples. Este Google Apps Script também organiza os e-mails que já estão na sua caixa de entrada, com regras como: aplicar um marcador em tudo dos domínios dos seus fornecedores, arquivar newsletters com mais de 14 dias, marcar recibos como lidos e colocá-los em Contas, ou marcar com estrela mensagens de clientes sem resposta depois de três dias. Ele funciona pela busca do Gmail, as mesmas palavras que você digita na caixa de pesquisa, então uma regra é fácil de ler e mudar. A partir do Padrão, as regras ficam em uma aba de planilha do Google que você edita, e um log mostra o que ele fez. Ele não apaga e-mails: aplica marcadores, arquiva e marca; mover para a Lixeira só entra se você passar essa regra. Você instala e roda na sua própria conta do Google.

O que está incluído

• O que você recebeUm arquivo ZIP com o código do Apps Script e um README que mostra como adicioná-lo à sua conta, autorizar o acesso e rodar; o código também aparece na página do pedido.
• E-mails antigos tambémFunciona no que já está na sua caixa de entrada
• Regras pela busca do Gmailfrom:, subject:, older_than: e os demais
• Marcadores, arquivar, lido, estrelaAs ações que você escolher para cada regra
• Nada apagado por padrãoLixeira só se você passar essa regra
• Código legívelCom comentários, fácil de incluir uma regra depois

Como funciona

1. 1
   RegrasVocê lista as regras em palavras simples
2. 2
   CódigoEscrevemos o script e o guia de instalação
3. 3
   TesteVocê roda primeiro com uma regra e confere os marcadores
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

As suas regras em palavras simples: quais e-mails (remetente ou domínio, palavras no assunto, idade, se tem anexo), o que fazer com eles (aplicar marcador, arquivar, marcar como lido, marcar com estrela) e os nomes dos marcadores que você usa. Mais ou menos quantos e-mails há na caixa e com que frequência os novos devem ser organizados. Se você usa um Gmail gratuito ou o Google Workspace. Nada de senhas nem capturas de tela de e-mails privados: remetentes de exemplo como loja.example bastam.

Vamos perguntar:

• O que deve ser organizado?
• O que deve acontecer com cada tipo?
• E-mails antigos também, ou só os novos?
• Algo que ele nunca deve fazer

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte