Datei-Uploads mit der Drive-API automatisieren

Die Automatisierung von Uploads gehört zu den nützlichsten Workflows der Drive-API. Berichte, Rechnungen, erzeugte Exporte, signierte PDF-Dateien und Support-Anhänge können ohne manuelles Ziehen und Ablegen im richtigen TrekMail Drive-Ordner landen.

Das sichere Verfahren ist einfach: Speicher prüfen, einen Ordner erstellen oder auswählen, Upload starten, Bytes übertragen, Upload abschließen und einen nützlichen Audit-Trail schreiben.

Empfohlene Berechtigungsbereiche

Beginnen Sie für Uploads in das Account Drive mit:

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

Verwenden Sie für Uploads in das Postfach-Drive:

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

Vermeiden Sie Freigabe- und endgültige Löschrechte, sofern derselbe Workflow sie nicht wirklich benötigt. Wenn der Upload-Auftrag auch öffentliche Links erstellt, fügen Sie den passenden Freigabebereich hinzu.

Vorabprüfungen

Rufen Sie vor dem Hochladen einer großen Datei den Endpunkt für die Speicherübersicht oder Speicherplatznutzung auf. Ihre Integration sollte „Kontingent überschritten“ als normales Geschäftsergebnis behandeln und nicht als Absturz.

Eine gute Automatisierung prüft außerdem, ob der Zielordner vorhanden ist. Andernfalls erstellen Sie ihn mit einem Idempotenzschlüssel, damit Wiederholungsversuche keine doppelten Ordner erzeugen.

REST-Upload-Ablauf

1. Senden Sie POST /api/v1/drive/spaces/{space}/uploads:initiate mit Dateiname, Größe, optionaler Ordner-ID und MIME-Typ.
2. Senden Sie die Datei-Bytes an die zurückgegebene Upload-URL oder die URLs für den mehrteiligen Upload.
3. Senden Sie nach erfolgreicher Übertragung POST /api/v1/drive/uploads/{file}:complete.
4. Schlägt die Übertragung fehl, rufen Sie POST /api/v1/drive/uploads/{file}:abort auf, um die Reservierung schnell freizugeben.

Verwenden Sie für die Initiierungsanfrage, die Upload-Kapazität reserviert, einen Idempotency-Key. Nutzen Sie pro logischer Datei einen stabilen Schlüssel, beispielsweise invoice-2026-05-001-upload. Gehen Sie nicht davon aus, dass jeder nachfolgende Upload-Endpunkt idempotente Ergebnisse erneut ausgibt. Bewahren Sie die zurückgegebene Datei-ID auf und prüfen Sie ihren Status, bevor Sie den Abschluss erneut versuchen oder eine Übertragung abbrechen.

MCP-Upload-Ablauf

Bevorzugen Sie für Agenten ein einzelnes Werkzeug:

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

Der MCP-Wrapper übernimmt Upload-Aushandlung, Übertragung, Abschluss und Abbruch bei Fehlern. Für eine angepasste Übertragungslogik stehen Werkzeuge auf niedriger Ebene bereit, die meisten Workflows benötigen sie jedoch nicht.

Konventionen für Namen und Ordner

Verwenden Sie vorhersehbare Namen, damit Menschen Drive später durchsuchen können:

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

Wenn ein Agent wiederholt Versionen hochlädt, fügen Sie Zeitstempel oder Versionsbezeichnungen hinzu. Vermeiden Sie Bedeutungsverlust, indem Sie jede Woche final.pdf hochladen.

Fehlerbehandlung

Planen Sie diese Fälle ein:

Nach dem Upload

Ist die Datei für eine externe Auslieferung vorgesehen, erstellen Sie einen Freigabelink mit Ablaufdatum und Download-Limit. Ist sie intern, belassen Sie sie als normale Drive-Datei. Prüfen Sie in beiden Fällen unter KI-Agenten & API → Audit-Protokoll das Token und die Abfolge der Aktionen.