Bestandsuploads automatiseren met de Drive-API

Uploadautomatisering is een van de nuttigste workflows van de Drive-API. Rapporten, facturen, gegenereerde exports, ondertekende PDF’s en supportbijlagen kunnen zonder handmatig slepen in de juiste TrekMail Drive-map terechtkomen.

Het veilige patroon is eenvoudig: controleer opslag, maak of kies een map, start de upload, draag bytes over, voltooi de upload en schrijf een nuttig auditspoor.

Aanbevolen scopes

Begin voor uploads naar Account Drive met:

• drive:account:read
• drive:account:write

Gebruik voor uploads naar Postvak Drive:

• drive:mailbox:read
• drive:mailbox:write

Vermijd scopes voor delen en definitief wissen, tenzij dezelfde workflow ze werkelijk nodig heeft. Voeg de passende deelscope toe als de uploadtaak ook openbare links maakt.

Controles vooraf

Roep vóór het uploaden van een groot bestand het endpoint voor het opslagoverzicht of ruimtegebruik aan. Behandel "quota overschreden" als een normaal bedrijfsresultaat, niet als een crash.

Goede automatisering controleert ook of de doelmap bestaat. Maak deze anders met een idempotentiesleutel, zodat nieuwe pogingen geen dubbele mappen maken.

REST-uploadproces

1. Stuur POST /api/v1/drive/spaces/{space}/uploads:initiate met bestandsnaam, grootte, optionele map-ID en MIME-type.
2. Stuur de bestandsbytes naar de geretourneerde upload-URL of meerdelige upload-URL’s.
3. Stuur POST /api/v1/drive/uploads/{file}:complete nadat de overdracht slaagt.
4. Roep bij een mislukte overdracht POST /api/v1/drive/uploads/{file}:abort aan om de reservering snel vrij te geven.

Gebruik een Idempotency-Key voor het initiële verzoek dat uploadcapaciteit reserveert. Gebruik per logisch bestand een stabiele sleutel, zoals invoice-2026-05-001-upload. Neem niet aan dat elk volgend endpoint idempotente resultaten herhaalt; bewaar de geretourneerde bestands-ID en controleer de status voordat u voltooiing opnieuw probeert of een overdracht afbreekt.

MCP-uploadproces

Gebruik voor agents bij voorkeur één hulpmiddel:

drive_file_upload(space="account", local_path="/exports/report.pdf", folder_id=42)

De MCP-wrapper verzorgt onderhandeling, overdracht, voltooiing en afbreken bij fouten. Voor aangepaste logica zijn hulpmiddelen op laag niveau beschikbaar, maar de meeste workflows hebben ze niet nodig.

Naam- en mapconventies

Gebruik voorspelbare namen zodat mensen later door Drive kunnen bladeren:

• Reports/2026/05/monthly-summary.pdf
• Clients/Acme/contracts/acme-renewal-2026.pdf
• Invoices/2026/INV-2026-0042.pdf

Voeg tijdstempels of versielabels toe als een agent herhaaldelijk versies uploadt. Verberg de betekenis niet door elke week final.pdf te uploaden.

Foutafhandeling

Houd rekening met deze gevallen:

Na de upload

Maak voor externe levering een deellink met vervaldatum en downloadlimiet. Laat een intern bestand als normaal Drive-bestand staan. Controleer in beide gevallen AI-agents en API → Auditlogboek om token en actiereeks te bevestigen.