Un Google Apps Script che salva gli allegati del suo Gmail in cartelle di Google Drive per mittente, data o tipo

Esempio di risultato

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Cartella: sales/2026-10, 9 file trovati
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 righe
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 righe
2026-11-02 09:14:04 WARN  shop-07.csv: saltate 3 righe senza prezzo (righe 88, 412, 913)
2026-11-02 09:14:05 INFO  Fatto: 10.412 righe -> report-2026-10.xlsx (fogli "Vendite" e "Totali")

[columns]
date = Data, Data vendita, Giorno
product = Prodotto, Articolo, Descrizione
quantity = Q.tà, Quantità, Pz
price = Prezzo, Prezzo unitario

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Legge il file di un negozio e gli dà i nomi di colonna del report."""
    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}: nessuna colonna per '{name}' (cercate: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Informazioni sul servizio

Fatture dei fornitori, documenti firmati, report inviati ogni settimana: quando gli allegati restano in Gmail, trovarne uno in seguito significa cercare tra le conversazioni. Questo Google Apps Script scorre la posta che seleziona con una ricerca di Gmail, per esempio quella dei fornitori con un PDF, e salva ogni allegato in una cartella di Google Drive: una cartella sola, o sottocartelle per mittente, mese o tipo di file, con nomi che includono data e mittente. Poi etichetta la posta come salvata, così nulla viene salvato due volte, e dallo Standard registra ogni file in un log. Le piccole immagini nelle firme si possono escludere. I file occupano spazio nel suo Drive. Un'esecuzione è limitata a circa sei minuti, quindi un grande arretrato va gestito a blocchi. Lo installa e lo esegue nel suo account Google.

Cosa è incluso

• Cosa riceveUn archivio ZIP con il codice Apps Script e un README che spiega come aggiungerlo al suo account, autorizzare l'accesso ed eseguirlo; il codice è visibile anche nella pagina dell'ordine.
• Posta tramite ricerca di Gmailes. from:@fornitore.example has:attachment
• Cartelle a modo suoUna cartella, o per mittente, mese o tipo
• Nomi di file chiariData e mittente aggiunti al nome
• Niente due volteLa posta salvata riceve un'etichetta e viene saltata la volta dopo
• Codice leggibileCon commenti, facile aggiungere una cartella in seguito

Come funziona

1. 1
   CompitoLei indica quale posta prendere e come organizzare le cartelle
2. 2
   CodiceScriviamo lo script e la guida all'installazione
3. 3
   Lo proviLo esegue prima su una ricerca ristretta e controlla la cartella
4. 4
   ModificheChiede modifiche nei limiti del pacchetto e invia eventuali messaggi di errore

Cosa ci serve da lei

Quale posta prendere: mittenti o domini, parole nell'oggetto, tipi di file, un intervallo di date, o una ricerca di Gmail che usa già. Come devono essere organizzate e chiamate le cartelle di Drive, come chiamare i file e cosa saltare (immagini delle firme, file sotto una certa dimensione). Circa quante email con allegati ci sono ora e ogni quanto ne arrivano di nuove, e se usa un Gmail gratuito o Google Workspace.

Le chiederemo:

• Quali allegati le servono?
• Come devono essere organizzate le cartelle?
• Come devono chiamarsi i file?
• Anche la posta vecchia, e ogni quanto?

Confronto dei pacchetti

Domande e risposte

Non hai trovato la risposta? Chiedi a noi