Operações em massa de arquivos do Drive por API/MCP

As operações em massa permitem que uma integração atue sobre muitos arquivos e pastas do Drive em uma única solicitação. Elas são úteis para arquivar pastas antigas, reverter uma limpeza equivocada, mover relatórios gerados ou limpar itens já revisados da lixeira.

Como as ações em massa podem afetar muitos dados, projete-as com escopos conservadores, visualizações prévias e revisão de auditoria.

O que as operações em massa podem fazer

O Drive oferece ações em massa para:

• Enviar arquivos e pastas à lixeira.
• Restaurar arquivos e pastas da lixeira.
• Mover arquivos e pastas para uma pasta de destino.
• Excluir permanentemente arquivos e pastas da lixeira.

As solicitações em massa podem incluir até 5.000 IDs selecionados. Para limpezas maiores, execute vários lotes revisados em vez de uma tarefa sem limites.

Seleção de IDs

Use os auxiliares de navegação, árvore de pastas, pesquisa ou seleção total para criar uma lista de IDs. O MCP inclui drive_select_all_ids para fluxos que precisam de "tudo nesta pasta" sem obrigar o agente a paginar manualmente.

Antes de executar um lote destrutivo, peça ao agente que resuma a ação planejada:

• Espaço do Drive de destino.
• Número de arquivos e pastas.
• Pasta de destino, se houver movimentação.
• Se a operação é recuperável.
• Escopo necessário e controle de segurança do 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

Use um cabeçalho Idempotency-Key em cada solicitação em massa. Se houver uma nova tentativa, o TrekMail poderá retornar o resultado original em vez de repetir o lote.

Ferramentas MCP

drive_bulk_trash
drive_bulk_restore
drive_bulk_move
drive_bulk_purge

drive_bulk_purge é permanente e exige o escopo de exclusão correspondente. Em um servidor MCP hospedado localmente, seu administrador também pode exigir TREKMAIL_ALLOW_DESTRUCTIVE=true antes que a ferramenta fique disponível.

Padrão de limpeza segura

Para a maioria das automações, use uma limpeza em duas etapas:

1. Mova arquivos antigos para uma pasta Archive ou para a lixeira.
2. Aguarde a revisão de uma pessoa ou uma tarefa de manutenção agendada separada antes da exclusão permanente.

Isso mantém o agente diário útil e preserva as opções de recuperação.

Projeto das permissões

Mantenha a exclusão permanente em um token separado. Se um fluxo apenas arquiva arquivos, ele não precisa desse recurso.