Einführung
Verbinden Sie Google Drive, damit Dateien in geteilten Ablagen als durchsuchbares Wissen in Docebo verfügbar werden.
Dieser Konnektor synchronisiert Dateien aus geteilten Ablagen, auf die das verbundene Konto Zugriff hat, mit Docebo Knowledge. Er umfasst nur den Inhalt von Drive-Dateien, nicht andere Google-Workspace-Apps.
1. Grundlegende Informationen
Welche Inhalte synchronisiert werden
| Inhaltstyp | Status | Hinweis |
|---|---|---|
| Dateien in geteilten Ablagen, denen das verbundene Konto angehört oder auf die es Zugriff hat | Synchronisiert | Google Docs, Tabellen, Präsentationen, PDFs und andere unterstützte Typen |
| Dateien in My Drive (persönliche Ablagen) | Nicht synchronisiert | Nicht Bestandteil des Umfangs, auch wenn sie einzeln für das verbundene Konto freigegeben wurden – siehe den Hinweis unten |
| Gmail, Kalender, Google Sites und andere Workspace-Apps | Nicht synchronisiert | Nicht Bestandteil des Umfangs dieses Konnektors |
| Dateien im Papierkorb | Nicht synchronisiert | |
| Antworten aus Google Forms | Nicht synchronisiert |
Welche Inhalte extrahiert werden
| Inhalt | Status |
|---|---|
| Textinhalt aus Docs, Tabellen, Präsentationen und PDFs | Extrahiert |
| Titel, Eigentümer, Ordnerpfad, Datum der letzten Änderung | Extrahiert |
| Eingebettete Bilder und Diagramme | Nicht extrahiert |
| Kommentare und Vorschläge | Nicht extrahiert |
| Versionsverlauf | Nicht extrahiert |
Dieser Konnektor synchronisiert nur geteilte Ablagen – er liest nicht die persönliche Ablage des verbundenen Kontos. Dateien, die direkt auf Dateiebene für dieses Konto freigegeben wurden, sich aber nicht in einer geteilten Ablage befinden, sind nicht Bestandteil des Umfangs. Verschieben Sie sie in eine geteilte Ablage, auf die das Konto Zugriff hat, oder fügen Sie sie dort hinzu, um sie zu synchronisieren.
2. Voraussetzungen im Quellsystem
Erforderliche Rolle
Das Google-Workspace-Konto, mit dem dieser Konnektor autorisiert wird, benötigt Administratorberechtigungen für Benutzer, Gruppen und Domains (in der Regel ein Workspace-Administratorkonto). Der Konnektor fordert neben dem Drive-Zugriff schreibgeschützte Bereiche des Admin Directory an. Diese API-Aufrufe schlagen bei einem Nicht-Administratorkonto fehl, auch wenn der Zustimmungsbildschirm selbst erfolgreich durchlaufen wird.
Erforderliche Einstellungen
Sowohl die Google Drive API als auch die Admin SDK API müssen im Google-Cloud-Projekt aktiviert sein – andernfalls werden die Bereiche des Admin Directory nicht in der Auswahl der Bereiche angezeigt.
Das verbundene Konto muss Mitglied jeder geteilten Ablage sein oder Zugriff auf diejenigen haben, die Sie synchronisieren möchten.
3. Vorbereitung im Quellsystem
Drive API aktivieren
Öffnen Sie die Seite der Google Drive API im Google Cloud Marketplace und wählen Sie für Ihr Projekt Aktivieren.
Eintrag der Google Drive API im Google Cloud Marketplace.
Anmeldedaten öffnen
Wählen Sie auf der Seite der Drive API die Option Verwalten. Wählen Sie in der linken Seitenleiste der daraufhin geöffneten Seite Anmeldedaten.
Detailseite des Drive-API-Dienstes mit Anmeldedaten in der linken Seitenleiste.
OAuth-Client-ID erstellen
Wählen Sie auf der Seite Anmeldedaten + Anmeldedaten erstellen → OAuth-Client-ID, wählen Sie Webanwendung und fügen Sie Ihre Weiterleitungs-URI unter Autorisierte Weiterleitungs-URIs hinzu. Sie folgt immer diesem Muster: https://[IHRE-DOCEBO-PLATTFORM-URL]/knowledge/v1/integrations/connections/callback – zum Beispiel https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
Client-ID für eine Webanwendung mit dem Abschnitt für die Weiterleitungs-URI und das Clientgeheimnis.
Speichern Sie und wählen Sie anschließend + Geheimnis hinzufügen, um ein Clientgeheimnis zu generieren. Kopieren Sie sowohl die Client-ID als auch das Clientgeheimnis – das Geheimnis wird nur einmal angezeigt.
Seite Anmeldedaten mit Anmeldedaten erstellen und der Liste der OAuth-2.0-Client-IDs.
Erforderliche Bereiche hinzufügen
Wählen Sie in der linken Seitenleiste Datenzugriff und anschließend Bereiche hinzufügen oder entfernen. Fügen Sie die folgenden Bereiche in das Feld Bereiche manuell hinzufügen ein, wählen Sie Zur Tabelle hinzufügen und anschließend Speichern.
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.activity.readonly
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/admin.directory.domain.readonly
https://www.googleapis.com/auth/admin.directory.group.readonly
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
| Bereich | Ermöglicht |
|---|---|
| drive.readonly | Alle Ihre Google-Drive-Dateien anzeigen und herunterladen |
| drive.activity.readonly | Aktivitätsprotokoll der Dateien in Ihrem Google Drive anzeigen |
| admin.directory.user.readonly | Informationen zu Benutzern in Ihrer Domain anzeigen |
| admin.directory.domain.readonly | Mit Ihren Kunden verknüpfte Domains anzeigen |
| admin.directory.group.readonly | Gruppen in Ihrer Domain anzeigen |
| userinfo.email | Ihre primäre E-Mail-Adresse des Google-Kontos anzeigen |
| userinfo.profile | Ihre persönlichen Daten anzeigen, einschließlich aller persönlichen Daten, die Sie öffentlich zugänglich gemacht haben |
Die oben genannten Bereiche des Admin Directory werden hier erst angezeigt, wenn die Admin SDK API zusätzlich zur Drive API in diesem Projekt aktiviert wurde.
Datenzugriff – Ausgewählte Bereiche aktualisieren, mit den manuell hinzugefügten Bereichen.
4. Erforderliche Aktionen in Docebo
| Einzugebende Informationen | Wo Sie sie finden |
|---|---|
| Client-ID | Google Cloud Console → APIs & Dienste → Anmeldedaten → Ihr OAuth-Client |
| Clientgeheimnis | Google Cloud Console → APIs & Dienste → Anmeldedaten → Ihr OAuth-Client (bei der Erstellung kopieren – es wird nicht erneut angezeigt) |
| ID der geteilten Ablage | Öffnen Sie die geteilte Ablage in Drive. Die ID ist der Teil der URL nach /folders/ |
Konnektor autorisieren
- Gehen Sie zu Add-ons und Integrationen → Wissenskonnektoren → Erstellen → Google Drive. Dieses Menü ist nur für Superadmins sichtbar.
- Geben Sie die Client-ID und das Clientgeheimnis ein.
Google Drive verbinden – Registerkarte Authentifizieren mit den Feldern für Client-ID und Clientgeheimnis.
- Wählen Sie Mit Google autorisieren und melden Sie sich mit einem Konto an, das auf die zu synchronisierenden Inhalte zugreifen kann.
- Wählen Sie die zu synchronisierenden geteilten Ablagen aus und wählen Sie anschließend Speichern.
Google Drive verbinden – Registerkarte Bereich zur Auswahl der zu synchronisierenden Ablagen.