Massenvorgänge für Drive-Dateien über API/MCP

Mit Massenvorgängen kann eine Integration in einer einzigen Anfrage Aktionen für viele Drive-Dateien und -Ordner ausführen. Sie eignen sich zum Archivieren alter Ordner, Wiederherstellen nach einer versehentlichen Bereinigung, Verschieben erstellter Berichte oder Leeren bereits geprüfter Papierkorbinhalte.

Da Massenaktionen viele Daten betreffen können, sollten Sie sie mit zurückhaltenden Berechtigungsbereichen, Vorschauen und Auditprüfungen gestalten.

Möglichkeiten von Massenvorgängen

Drive unterstützt Massenaktionen für folgende Aufgaben:

• Dateien und Ordner in den Papierkorb legen.
• Dateien und Ordner aus dem Papierkorb wiederherstellen.
• Dateien und Ordner in einen Zielordner verschieben.
• Dateien und Ordner im Papierkorb endgültig löschen.

Massenanfragen können bis zu 5.000 ausgewählte IDs enthalten. Führen Sie bei größeren Bereinigungen mehrere geprüfte Batches statt eines unbegrenzten Auftrags aus.

IDs auswählen

Verwenden Sie Hilfsfunktionen zum Durchsuchen, für den Ordnerbaum, die Suche oder die Auswahl aller Elemente, um eine ID-Liste zu erstellen. MCP enthält drive_select_all_ids für Abläufe, die "alles in diesem Ordner" benötigen, ohne dass der Agent die Seitennavigation manuell durchführen muss.

Lassen Sie den Agenten vor einem destruktiven Batch die geplante Aktion zusammenfassen:

• Drive-Zielbereich.
• Anzahl der Dateien und Ordner.
• Zielordner bei einer Verschiebung.
• Ob der Vorgang rückgängig gemacht werden kann.
• Erforderlicher Berechtigungsbereich und MCP-Sicherheitsmechanismus.

REST-Endpunkte

POST /api/v1/drive/spaces/{space}/bulk:trash
POST /api/v1/drive/spaces/{space}/bulk:restore
POST /api/v1/drive/spaces/{space}/bulk:move
POST /api/v1/drive/spaces/{space}/bulk:purge

Verwenden Sie für jede Massenanfrage einen Idempotency-Key-Header. Bei einem erneuten Versuch kann TrekMail das ursprüngliche Ergebnis zurückgeben, anstatt den Batch zu wiederholen.

MCP-Tools

drive_bulk_trash
drive_bulk_restore
drive_bulk_move
drive_bulk_purge

drive_bulk_purge ist endgültig und erfordert den passenden Löschbereich. Bei einem lokal gehosteten MCP-Server kann dessen Administrator zusätzlich TREKMAIL_ALLOW_DESTRUCTIVE=true verlangen, bevor das Tool verfügbar ist.

Muster für sichere Bereinigung

Verwenden Sie für die meisten Automatisierungen eine Bereinigung in zwei Schritten:

1. Verschieben Sie alte Dateien in einen Archive-Ordner oder in den Papierkorb.
2. Warten Sie vor dem endgültigen Löschen auf eine menschliche Prüfung oder einen separaten geplanten Wartungsauftrag.

So bleibt der täglich eingesetzte Agent nützlich, während Wiederherstellungsoptionen erhalten bleiben.

Gestaltung der Berechtigungen

Bewahren Sie die Berechtigung zum endgültigen Löschen in einem separaten Token auf. Wenn ein Ablauf Dateien nur archiviert, benötigt er diese Berechtigung überhaupt nicht.