Opérations groupées sur les fichiers Drive via API/MCP

Les opérations groupées permettent à une intégration d'agir sur de nombreux fichiers et dossiers Drive en une seule requête. Elles servent à archiver d'anciens dossiers, à annuler un nettoyage effectué par erreur, à déplacer des rapports générés ou à vider des éléments de la corbeille déjà examinés.

Les actions groupées pouvant toucher beaucoup de données, concevez-les avec des portées prudentes, des aperçus et un examen des journaux d'audit.

Possibilités des opérations groupées

Drive prend en charge les actions groupées pour :

• Mettre des fichiers et des dossiers à la corbeille.
• Restaurer des fichiers et des dossiers depuis la corbeille.
• Déplacer des fichiers et des dossiers vers un dossier cible.
• Purger définitivement les fichiers et dossiers mis à la corbeille.

Les requêtes groupées peuvent inclure jusqu'à 5 000 identifiants sélectionnés. Pour les nettoyages plus importants, exécutez plusieurs lots examinés plutôt qu'une tâche sans limites.

Sélection des identifiants

Utilisez les assistants de navigation, d'arborescence, de recherche ou de sélection globale pour constituer une liste d'identifiants. MCP inclut drive_select_all_ids pour les workflows qui ont besoin de « tout ce qui se trouve dans ce dossier » sans obliger l'agent à gérer manuellement la pagination.

Avant d'exécuter un lot destructif, demandez à l'agent de résumer l'action prévue :

• Espace Drive cible.
• Nombre de fichiers et de dossiers.
• Dossier de destination, en cas de déplacement.
• Possibilité de récupération de l'opération.
• Portée requise et dispositif de sécurité MCP.

Endpoints 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

Utilisez un en-tête Idempotency-Key pour chaque requête groupée. En cas de nouvelle tentative, TrekMail peut renvoyer le résultat d'origine au lieu de répéter le lot.

Outils MCP

drive_bulk_trash
drive_bulk_restore
drive_bulk_move
drive_bulk_purge

drive_bulk_purge est définitif et nécessite la portée de purge correspondante. Sur un serveur MCP hébergé localement, son administrateur peut également exiger TREKMAIL_ALLOW_DESTRUCTIVE=true avant de le rendre disponible.

Modèle de nettoyage sécurisé

Pour la plupart des automatisations, utilisez un nettoyage en deux étapes :

1. Déplacez les anciens fichiers vers un dossier Archive ou vers la corbeille.
2. Attendez l'examen par une personne ou une tâche de maintenance planifiée distincte avant la purge.

Ainsi, l'agent utilisé au quotidien reste utile tout en préservant les possibilités de récupération.

Conception des autorisations

Conservez la purge dans un jeton distinct. Si un workflow se contente d'archiver des fichiers, il n'a aucunement besoin de la purge.

Articles connexes

• Opérations groupées sur les fichiers
• Sécurité de Drive, piste d'audit et règles de suppression/purge sécurisée
• Présentation des outils MCP Drive