Um Google Apps Script que salva os anexos do seu Gmail em pastas do Google Drive por remetente, data ou tipo

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

Notas fiscais de fornecedores, documentos assinados, relatórios enviados toda semana: quando os anexos ficam no Gmail, achar um depois significa vasculhar as conversas. Este Google Apps Script percorre os e-mails que você escolher com uma busca do Gmail, como os dos seus fornecedores com PDF, e salva cada anexo em uma pasta do Google Drive: uma pasta só, ou subpastas por remetente, mês ou tipo de arquivo, com nomes que incluem a data e o remetente. Depois ele aplica um marcador de salvo no e-mail, para nada ser salvo duas vezes, e, a partir do Padrão, registra cada arquivo em um log. Imagens pequenas de assinaturas podem ficar de fora. Os arquivos ocupam espaço no seu Drive. Uma execução é limitada a cerca de seis minutos, então um acúmulo grande vai em partes. Você instala e roda na sua 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 pela busca do Gmailex.: from:@fornecedor.example has:attachment
• Pastas do seu jeitoUma pasta, ou por remetente, mês ou tipo
• Nomes de arquivo clarosData e remetente incluídos no nome
• Nada duas vezesOs e-mails salvos ganham um marcador e são pulados da próxima vez
• Código legívelCom comentários, fácil de incluir uma pasta depois

Como funciona

1. 1
   TarefaVocê diz quais e-mails pegar e como organizar as pastas
2. 2
   CódigoEscrevemos o script e o guia de instalação
3. 3
   TesteVocê roda primeiro com uma busca restrita e confere a pasta
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

Quais e-mails pegar: remetentes ou domínios, palavras no assunto, tipos de arquivo, um período, ou uma busca do Gmail que você já usa. Como as pastas do Drive devem ser organizadas e nomeadas, como os arquivos devem ser nomeados e o que pular (imagens de assinatura, arquivos abaixo de certo tamanho). Mais ou menos quantos e-mails com anexos existem hoje e com que frequência chegam novos, e se você usa um Gmail gratuito ou o Google Workspace.

Vamos perguntar:

• De quais anexos você precisa?
• Como as pastas devem ser organizadas?
• Como os arquivos devem ser nomeados?
• E-mails antigos também, e com que frequência?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte