Operazioni in blocco sui file Drive tramite API/MCP

Le operazioni in blocco consentono a un'integrazione di agire su molti file e cartelle di Drive con una sola richiesta. Sono utili per archiviare vecchie cartelle, annullare una pulizia eseguita per errore, spostare report generati o eliminare elementi già controllati dal cestino.

Poiché le azioni in blocco possono interessare molti dati, progettale con ambiti prudenti, anteprime e revisioni dell'audit.

Cosa possono fare le operazioni in blocco

Drive supporta azioni in blocco per:

• Cestinare file e cartelle.
• Ripristinare file e cartelle dal cestino.
• Spostare file e cartelle in una cartella di destinazione.
• Eliminare definitivamente file e cartelle nel cestino.

Le richieste in blocco possono includere fino a 5.000 ID selezionati. Per le pulizie più grandi, esegui più batch controllati anziché un unico processo senza limiti.

Selezione degli ID

Usa le funzioni di supporto per l'esplorazione, l'albero delle cartelle, la ricerca o la selezione totale per creare un elenco di ID. MCP include drive_select_all_ids per i flussi che richiedono "tutto ciò che si trova in questa cartella" senza obbligare l'agente a gestire manualmente la paginazione.

Prima di eseguire un batch distruttivo, chiedi all'agente di riepilogare l'azione pianificata:

• Spazio Drive di destinazione.
• Numero di file e cartelle.
• Cartella di destinazione, in caso di spostamento.
• Possibilità di recuperare l'operazione.
• Ambito richiesto e controllo di sicurezza MCP.

Endpoint REST

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

Usa un'intestazione Idempotency-Key per ogni richiesta in blocco. Se si verifica un nuovo tentativo, TrekMail può restituire il risultato originale anziché ripetere il batch.

Strumenti MCP

drive_bulk_trash
drive_bulk_restore
drive_bulk_move
drive_bulk_purge

drive_bulk_purge è permanente e richiede l'ambito di eliminazione definitiva corrispondente. In un server MCP ospitato localmente, l'amministratore può anche richiedere TREKMAIL_ALLOW_DESTRUCTIVE=true prima che lo strumento sia disponibile.

Modello di pulizia sicura

Per la maggior parte delle automazioni, usa una pulizia in due passaggi:

1. Sposta i vecchi file in una cartella Archive o nel cestino.
2. Attendi la revisione di una persona o un processo di manutenzione pianificato separato prima dell'eliminazione definitiva.

In questo modo l'agente usato quotidianamente rimane utile e le opzioni di recupero vengono preservate.

Progettazione delle autorizzazioni

Mantieni l'eliminazione definitiva in un token separato. Se un flusso si limita ad archiviare file, non ha affatto bisogno di questa autorizzazione.