Instructie
difficulty level:
Beheer > Integraties > Google Drive
Google Drive-Verbindung einrichten: Schritte auf der Google- und der i-Reserve-Seite
Die Google Drive-Verbindung erfordert eine Konfiguration auf zwei Seiten: zunächst einen OAuth-Client in Google Cloud, anschließend die Verbindung selbst in i-Reserve.
1. Auf der Google Cloud-Seite
- Öffnen Sie die Google Cloud Console und erstellen/wählen Sie ein Projekt.
- APIs & Services → Library: suchen Sie die Google Drive API und klicken Sie auf Enable.
- OAuth consent screen: wählen Sie den Benutzertyp (in der Regel Internal innerhalb des eigenen Workspace), tragen Sie App-Name und Support-E-Mail ein und fügen Sie den Drive-Scope (
.../auth/drive) hinzu. - Credentials → Create credentials → OAuth client ID, Typ Web application.
- Fügen Sie unter Authorized redirect URIs die Redirect-URI hinzu, die i-Reserve anzeigt (z. B.
{base_url}/integrations/redirect/{int_id}). - Notieren Sie die Client ID und das Client secret.
2. Auf der i-Reserve-Seite
Gehen Sie zu Verwaltung → Integrationen und fügen Sie eine Google Drive-Verbindung hinzu.
2.1 Authentifizierungs-Bildschirm
| Feld | Was einzutragen ist |
|---|---|
| Client ID | Die OAuth-Client-ID aus Google Cloud. |
| Client secret | Das zugehörige Client-Secret. |
| Return url | Die Redirect-URI; verwenden Sie exakt den Wert, den i-Reserve anzeigt, und registrieren Sie dieselbe URI im Google-Client. |
Danach folgen zwei Schaltflächen: Schritt 1: Zustimmung (Google-Consent-Bildschirm, melden Sie sich mit dem gewünschten Konto an) und Schritt 2: Verbinden (tauscht die Zustimmung gegen die Tokens ein und testet die Verbindung).
2.2 Konfigurations-Bildschirm
| Feld | Was einzutragen ist |
|---|---|
| Basisordner-ID | Der Drive-Ordner, unter dem alles liegt (root = My Drive, oder eine bestimmte Ordner-ID aus der Drive-URL). |
| Basisordner-Name | Anzeigename für den Basisordner (informativ, z. B. i-Reserve). |
| Unterordner-Muster | Die Pfadvorlage für Entitäts-Ordner, mit den Tokens {context}, {itemname} und {itemid} (z. B. {context}/{itemname} (#{itemid})). |
| Unterordner automatisch erstellen | Ja/Nein — fehlende Entitäts-Ordner bei der ersten Verwendung automatisch erstellen, oder nur bestehende Ordner anzeigen. |
2.3 Aktivieren
Speichern Sie und setzen Sie die Verbindung auf aktiv. Der Dateimanager ist danach bei den Entitäten verfügbar (sofern das CRM-Modul aktiv ist und der Benutzer die Drive-Berechtigungen hat).
Die Drive-Verbindung benötigt das CRM-Modul und gewährt pro Entität Zugang auf Basis von Berechtigungen (Lesen / Anlegen / Löschen). Ohne diese Berechtigungen sieht der Benutzer den Dateimanager nicht.
Google-native Dateien (.gdoc/.gsheet/.gslides) können nicht über den Dateimanager hochgeladen werden; es handelt sich um Verweise, nicht um echte Dateien. Verschieben Sie Google Docs innerhalb von Drive selbst.
