Bulkbewerkingen voor Drive-bestanden via API/MCP

Met bulkbewerkingen kan een integratie in één verzoek acties uitvoeren op veel Drive-bestanden en -mappen. Ze zijn nuttig voor het archiveren van oude mappen, het herstellen van een onbedoelde opschoning, het verplaatsen van gegenereerde rapporten of het wissen van gecontroleerde prullenbakitems.

Omdat bulkacties veel gegevens kunnen raken, moet je ze ontwerpen met terughoudende scopes, voorbeelden en auditcontroles.

Wat bulkbewerkingen kunnen doen

Drive ondersteunt bulkacties voor:

• Bestanden en mappen naar de prullenbak verplaatsen.
• Bestanden en mappen uit de prullenbak herstellen.
• Bestanden en mappen naar een doelmap verplaatsen.
• Bestanden en mappen in de prullenbak permanent wissen.

Bulkverzoeken kunnen maximaal 5.000 geselecteerde ID's bevatten. Voer voor grotere opschoonacties meerdere gecontroleerde batches uit in plaats van één onbeperkte taak.

ID's selecteren

Gebruik hulpmiddelen voor bladeren, de mappenstructuur, zoeken of alles selecteren om een lijst met ID's samen te stellen. MCP bevat drive_select_all_ids voor workflows die "alles in deze map" nodig hebben zonder dat de agent handmatig door pagina's hoeft te gaan.

Laat de agent de geplande actie samenvatten voordat je een destructieve batch uitvoert:

• Doelruimte in Drive.
• Aantal bestanden en mappen.
• Doelmap, bij een verplaatsing.
• Of de bewerking kan worden hersteld.
• Vereiste scope en MCP-veiligheidscontrole.

REST-endpoints

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

Gebruik bij elk bulkverzoek een Idempotency-Key-header. Als het verzoek opnieuw wordt geprobeerd, kan TrekMail het oorspronkelijke resultaat teruggeven in plaats van de batch te herhalen.

MCP-tools

drive_bulk_trash
drive_bulk_restore
drive_bulk_move
drive_bulk_purge

drive_bulk_purge is permanent en vereist de bijbehorende scope voor permanent wissen. Op een lokaal gehoste MCP-server kan de beheerder ook TREKMAIL_ALLOW_DESTRUCTIVE=true vereisen voordat deze beschikbaar is.

Patroon voor veilig opschonen

Gebruik voor de meeste automatiseringen een opschoning in twee stappen:

1. Verplaats oude bestanden naar een map Archive of naar de prullenbak.
2. Wacht op menselijke controle of een afzonderlijke geplande onderhoudstaak voordat je ze permanent wist.

Zo blijft de dagelijkse agent nuttig, terwijl herstelmogelijkheden behouden blijven.

Machtigingen ontwerpen

Bewaar permanent wissen in een afzonderlijk token. Als een workflow alleen bestanden archiveert, heeft deze die machtiging helemaal niet nodig.