Ein Google Apps Script, das Ihr Gmail nach Regeln labelt, archiviert und aufräumt, die normale Filter nicht schaffen

Beispielergebnis

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Ordner: sales/2026-10, 9 Dateien gefunden
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 Zeilen
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 Zeilen
2026-11-02 09:14:04 WARN  shop-07.csv: 3 Zeilen ohne Preis übersprungen (Zeilen 88, 412, 913)
2026-11-02 09:14:05 INFO  Fertig: 10.412 Zeilen -> report-2026-10.xlsx (Tabellenblätter „Verkäufe“ und „Summen“)

[columns]
date = Datum, Verkaufsdatum, Tag
product = Artikel, Produkt, Bezeichnung
quantity = Menge, Anzahl, Stk.
price = Preis, Einzelpreis

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Liest die Datei eines Ladens ein und gibt ihr die Spaltennamen des Berichts."""
    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}: keine Spalte für '{name}' (gesucht wurde nach {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Über diese Leistung

Gmail-Filter wirken nur auf neue E-Mails und nur nach einfachen Bedingungen. Dieses Google Apps Script räumt auch die E-Mails auf, die bereits in Ihrem Posteingang liegen, nach Regeln wie: alles von den Domains Ihrer Lieferanten labeln, Newsletter älter als 14 Tage archivieren, Belege als gelesen markieren und unter „Buchhaltung“ ablegen oder unbeantwortete Nachrichten von Kunden nach drei Tagen mit einem Stern versehen. Es arbeitet mit der Gmail-Suche, also denselben Begriffen, die Sie ins Suchfeld tippen, daher ist eine Regel leicht zu lesen und zu ändern. Ab Standard stehen die Regeln auf einem Tabellenblatt einer Google Tabelle, das Sie bearbeiten, und ein Protokoll zeigt, was es getan hat. Es löscht keine E-Mails: Es labelt, archiviert und markiert; das Verschieben in den Papierkorb kommt nur hinzu, wenn Sie diese Regel vorgeben. Sie installieren und starten es in Ihrem eigenen Google-Konto.

Was enthalten ist

• Das erhalten SieEin ZIP-Archiv mit dem Apps-Script-Code und einer README, die zeigt, wie Sie ihn zu Ihrem Konto hinzufügen, den Zugriff erlauben und ihn starten; der Code wird auch auf der Bestellseite angezeigt.
• Auch alte E-MailsWirkt auf das, was schon in Ihrem Posteingang liegt
• Regeln per Gmail-Suchefrom:, subject:, older_than: und die übrigen
• Labeln, archivieren, gelesen, SternDie Aktionen, die Sie für jede Regel wählen
• Standardmäßig kein LöschenPapierkorb nur, wenn Sie diese Regel vorgeben
• Lesbarer CodeMit Kommentaren, eine Regel lässt sich später leicht ergänzen

So funktioniert es

1. 1
   RegelnSie beschreiben die Regeln in einfachen Worten
2. 2
   CodeWir schreiben das Skript und die Installationsanleitung
3. 3
   AusprobierenSie starten es zuerst mit einer Regel und prüfen die Labels
4. 4
   ÜberarbeitungenSie wünschen Überarbeitungen im Rahmen Ihres Pakets und schicken etwaige Fehlermeldungen

Was wir von Ihnen brauchen

Ihre Regeln in einfachen Worten: welche E-Mails (Absender oder Domain, Wörter im Betreff, Alter, mit Anhang), was damit geschehen soll (labeln, archivieren, als gelesen markieren, Stern) und die Labelnamen, die Sie verwenden. Ungefähr wie viele E-Mails im Postfach liegen und wie oft neue E-Mails sortiert werden sollen. Ob Sie ein kostenloses Gmail oder Google Workspace nutzen. Keine Passwörter und keine Screenshots privater E-Mails: Beispielabsender wie shop.example genügen.

Wir fragen Sie:

• Was soll sortiert werden?
• Was soll mit jeder Art geschehen?
• Auch alte E-Mails oder nur neue?
• Was es nie tun darf

Pakete vergleichen

Fragen und Antworten

Keine Antwort gefunden? Fragen Sie uns