Operaciones masivas con archivos de Drive mediante API/MCP

Las operaciones masivas permiten que una integración actúe sobre muchos archivos y carpetas de Drive en una sola solicitud. Son útiles para archivar carpetas antiguas, revertir una limpieza equivocada, mover informes generados o vaciar elementos de la papelera que ya se han revisado.

Como las acciones masivas pueden afectar a muchos datos, diséñalas con ámbitos conservadores, vistas previas y revisión de auditoría.

Qué pueden hacer las operaciones masivas

Drive admite acciones masivas para:

• Enviar archivos y carpetas a la papelera.
• Restaurar archivos y carpetas desde la papelera.
• Mover archivos y carpetas a una carpeta de destino.
• Purgar permanentemente archivos y carpetas de la papelera.

Las solicitudes masivas pueden incluir hasta 5.000 identificadores seleccionados. Para limpiezas mayores, ejecuta varios lotes revisados en lugar de una tarea sin límites.

Seleccionar identificadores

Utiliza las funciones auxiliares de exploración, árbol de carpetas, búsqueda o selección total para crear una lista de identificadores. MCP incluye drive_select_all_ids para flujos que necesitan "todo lo que hay en esta carpeta" sin obligar al agente a paginar manualmente.

Antes de ejecutar un lote destructivo, pide al agente que resuma la acción planificada:

• Espacio de Drive de destino.
• Número de archivos y carpetas.
• Carpeta de destino, si se van a mover.
• Si la operación es recuperable.
• Ámbito necesario y control de seguridad de 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

Utiliza un encabezado Idempotency-Key en cada solicitud masiva. Si se produce un reintento, TrekMail puede devolver el resultado original en vez de repetir el lote.

Herramientas MCP

drive_bulk_trash
drive_bulk_restore
drive_bulk_move
drive_bulk_purge

drive_bulk_purge es permanente y requiere el ámbito de purga correspondiente. En un servidor MCP alojado localmente, su administrador también puede exigir TREKMAIL_ALLOW_DESTRUCTIVE=true para que esté disponible.

Patrón de limpieza segura

Para la mayoría de las automatizaciones, utiliza una limpieza en dos pasos:

1. Mueve los archivos antiguos a una carpeta Archive o a la papelera.
2. Espera la revisión de una persona o una tarea de mantenimiento programada independiente antes de purgar.

Así, el agente diario sigue siendo útil y se conservan las opciones de recuperación.

Diseño de permisos

Mantén la purga en un token independiente. Si un flujo solo archiva archivos, no necesita purga en absoluto.