Google Drive-Verbindung: Methode und funktionaler Hintergrund
Die Google Drive-Verbindung stellt i-Reserve einen Dateimanager oberhalb eines Google Drive-Kontos des Kunden selbst zur Verfügung. Benutzer mit den entsprechenden Berechtigungen können aus i-Reserve heraus Dokumente pro Entität (Kunde, Buchung, Unternehmen, Veranstaltung oder Objekt) ansehen, hochladen, umbenennen, verschieben, kopieren und löschen. Die Verbindung nutzt die Google Drive API v3.
Wichtig: interaktiv, nicht ereignisgesteuert
Anders als die Kalender-Verbindungen kennt die Drive-Verbindung keine automatischen Trigger auf Buchungsstatus. Es werden also nicht von selbst Dateien bei einer Statusänderung erstellt. Die Verbindung ist interaktiv: Dateien werden über den Dateimanager (ein Dashboard-Block / eine UI-Komponente) verwaltet, der die Drive-Operationen direkt ausführt.
Authentifizierung
Delegiertes OAuth 2.0 (Authorization-Code-Flow) mit dem Scope https://www.googleapis.com/auth/drive. Der Kunde stellt einen eigenen OAuth-Client bereit, sodass nur dessen eigenes Drive-Konto angesprochen wird. i-Reserve bewahrt access_token + refresh_token auf und erneuert diese automatisch (bei einem 401). Verfällt der Refresh-Token (z. B. widerrufene Zustimmung), ist ein erneutes Verbinden erforderlich.
Ordnerstruktur pro Entität
Die Verbindung erstellt und verwendet eine Ordnerstruktur auf Basis eines einstellbaren Musters, zum Beispiel {context}/{itemname} (#{itemid}) — was zu Ordnern wie customer/Jan Jansen (#1234) oder booking/Ochtendslot (#567) führt. Die Auflösung Entität → Drive-Ordner-ID wird zwischengespeichert, sodass nicht jedes Mal neu gesucht werden muss; ein Administrator kann einen Ordner auch manuell fixieren (Override). Optional werden fehlende Ordner bei der ersten Verwendung automatisch erstellt.
Was der Dateimanager kann
- Ordner und Dateien auflisten, Thumbnails anzeigen, Dateien herunterladen/streamen.
- Ordner erstellen, umbenennen, löschen (in den Papierkorb).
- Dateien hochladen, umbenennen, verschieben, kopieren, löschen.
- Einen teilbaren (öffentlichen) Link generieren.
Jede Operation ist berechtigungsgesteuert (Lesen / Erstellen / Löschen pro Entitätstyp).
Einschränkungen
- CRM-Modul erforderlich: ohne das CRM-Lizenzmodul ist die Verbindung nicht verfügbar.
- Google-native Dateien (Docs/Sheets/Slides,
.gdoc/.gsheet) können nicht hochgeladen werden — das sind Verweise, keine echten Dateien. Verschieben Sie Google Docs innerhalb von Drive selbst. - Dateien liegen in der Drive-Identität der Verbindung; das Öffnen erfolgt über den Drive-Weblink, Downloads/Thumbnails laufen über den OAuth-Token der Verbindung.
- Die Redirect-URI muss exakt mit dem übereinstimmen, was im Google-Projekt registriert ist.
