Un Google Apps Script qui enregistre les pièces jointes de votre Gmail dans des dossiers Google Drive par expéditeur, date ou type

Exemple de résultat

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Dossier : sales/2026-10, 9 fichiers trouvés
2026-11-02 09:14:03 INFO  shop-01.csv : 1 284 lignes
2026-11-02 09:14:04 INFO  shop-02.xlsx : 967 lignes
2026-11-02 09:14:04 WARN  shop-07.csv : 3 lignes sans prix ignorées (lignes 88, 412, 913)
2026-11-02 09:14:05 INFO  Terminé : 10 412 lignes -> report-2026-10.xlsx (feuilles « Ventes » et « Totaux »)

[columns]
date = Date, Date de vente, Jour
product = Produit, Article, Désignation
quantity = Qté, Quantité, Pièces
price = Prix, Prix unitaire

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lit le fichier d’une boutique et lui donne les noms de colonnes du rapport."""
    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} : aucune colonne pour '{name}' (recherché : {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

À propos de ce service

Factures de fournisseurs, documents signés, rapports envoyés chaque semaine : quand les pièces jointes restent dans Gmail, en retrouver une plus tard oblige à fouiller les conversations. Ce Google Apps Script parcourt les messages choisis par une recherche Gmail, par exemple ceux de vos fournisseurs avec un PDF, et enregistre chaque pièce jointe dans un dossier Google Drive : un seul dossier, ou des sous-dossiers par expéditeur, par mois ou par type de fichier, avec des noms incluant la date et l’expéditeur. Il applique ensuite un libellé aux messages traités, pour que rien ne soit enregistré deux fois, et dès Standard inscrit chaque fichier dans un journal. Les petites images des signatures peuvent être ignorées. Les fichiers occupent de l’espace dans votre Drive. Une exécution est limitée à environ six minutes : un gros arriéré se traite en plusieurs fois. Vous l’installez et le lancez dans votre compte Google.

Ce qui est inclus

• Ce que vous recevezUne archive ZIP avec le code Apps Script et un README qui montre comment l’ajouter à votre compte, autoriser l’accès et le lancer ; le code est aussi affiché sur la page de la commande.
• Messages choisis par recherche Gmailex. : from:@supplier.example has:attachment
• Dossiers à votre façonUn dossier, ou par expéditeur, par mois ou par type
• Noms de fichiers clairsDate et expéditeur ajoutés au nom
• Rien en doubleLes messages traités reçoivent un libellé et sont ignorés la fois suivante
• Code lisibleAvec des commentaires, pour ajouter facilement un dossier plus tard

Comment ça marche

1. 1
   TâcheVous indiquez quels messages prendre et comment organiser les dossiers
2. 2
   CodeNous écrivons le script et le guide d’installation
3. 3
   Testez-leVous le lancez d’abord sur une recherche restreinte et vérifiez le dossier
4. 4
   RetouchesVous demandez des retouches selon votre formule et envoyez les éventuels messages d’erreur

Ce dont nous avons besoin

Quels messages prendre : expéditeurs ou domaines, mots dans l’objet, types de fichiers, période, ou une recherche Gmail que vous utilisez déjà. L’organisation et les noms des dossiers Drive, le nom des fichiers et ce qu’il faut ignorer (images de signature, fichiers sous une certaine taille). Le nombre approximatif d’e-mails avec pièces jointes actuellement et la fréquence d’arrivée des nouveaux, et si vous utilisez un Gmail gratuit ou Google Workspace.

Nous vous demanderons :

• De quelles pièces jointes avez-vous besoin ?
• Comment organiser les dossiers ?
• Comment nommer les fichiers ?
• Les anciens messages aussi, et à quelle fréquence ?

Comparer les formules

Questions et réponses

Vous n’avez pas trouvé la réponse ? Posez-nous la question