Zum Hauptinhalt springen

Google Drive-Integration - Einrichtungsanleitung

Verbinde dein Google Drive-Konto mit Goodweek, um Dateien und Ordner, die in Google Drive gespeichert sind, direkt aus deinem KI-Arbeitsbereich abzurufen, hochzuladen und zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein Google Drive-Konto mit Goodweek, um Dateien und Ordner, die in Google Drive gespeichert sind, direkt aus deinem KI-Arbeitsbereich abzurufen, hochzuladen und zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die Zugriffsebenen, die dem Benutzer innerhalb von Google Drive gewährt wurden, und gewährleistet so die Einhaltung der Governance-Richtlinien deiner Organisation. Die Ergebnisse und verfügbaren Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff der einzelnen Benutzer variieren.

📋 Voraussetzungen

Bevor Benutzer die Google-Drive-Integration sehen und verbinden können, muss dein Organisationsadministrator sie zunächst im Goodweek Admin-Panel im Tab Integrationen aktivieren.

Admin-Einrichtung

Persönliche Google-Konten (@gmail.com)

Keine Admin-Einrichtung erforderlich. Verbinde dich direkt, indem du die unten stehenden Schritte zur Benutzerverbindung befolgst.

Google Workspace-Konten (geschäftlich oder schulisch)

Google Drive fordert umfassende Dateizugriffsbereiche an, die von Google Workspace-Administratoren häufig als hochriskant eingestuft werden. Dadurch ist eine Admin-Einschränkung bei Drive wahrscheinlicher als bei anderen Google-Integrationen.

Szenario 1 – Standard (uneingeschränkter Drittanbieterzugriff)

Jeder Benutzer kann sich direkt verbinden, ohne dass ein Administrator eingreifen muss.

Szenario 2 – Der Drittanbieterzugriff ist eingeschränkt (Fehler admin_policy_enforced)

Ein Google Workspace-Superadministrator muss Composio als vertrauenswürdige App kennzeichnen:

  1. Melde dich bei admin.google.com als Superadministrator an.

  2. Gehe zu Sicherheit → Zugriffs- und Datenkontrolle → API-Steuerelemente → Zugriff von Drittanbieter-Apps verwalten.

  3. Klicke auf Neue App konfigurieren, suche nach Composio, wähle sie aus, setze den Zugriff auf Vertrauenswürdig und klicke auf Speichern.

Szenario 3 – Der gesamte Drittanbieter-API-Zugriff ist blockiert

Gehe zu admin.google.com → Sicherheit → API-Steuerelemente und überprüfe die Einstellung „Drittanbieter-App-Zugriff auf Google APIs". Falls blockiert, muss der Administrator vor Befolgen von Szenario 2 eine Ausnahme für Composio erstellen.

Benutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche Google Drive und klicke auf Verbinden.

  3. Du wirst zu Google weitergeleitet, wo du dich anmelden musst.

  4. Überprüfe die angeforderten Berechtigungen und klicke auf Zulassen, um zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Benutzer muss sein eigenes Konto individuell verbinden.

  • Goodweek kann nur auf die Dateien und Ordner zugreifen, für die dein individuelles Benutzerkonto Berechtigungen hat. Freigegebene Dateien sind nur zugänglich, wenn dir die entsprechenden Freigabeberechtigungen erteilt wurden.

  • Wenn du mehrere Google-Konten hast, stelle sicher, dass du beim Verbindungsschritt das richtige auswählst.

  • Du kannst den Zugriff von Goodweek jederzeit über myaccount.google.com → Sicherheit → Apps von Drittanbietern mit Kontozugriff widerrufen.


Verfügbare Tools

Tool

Beschreibung

Typ

Find File

Umfassende Suche in Google Drive nach Dateien und Ordnern anhand von Name, Typ, Inhalt und weiteren Filtern.

Lesen

Find Folder

Findet Ordner anhand des Namens innerhalb eines übergeordneten Ordners in Google Drive.

Lesen

Get File Metadata

Ruft die Metadaten einer Datei anhand der ID ab, einschließlich Typ, übergeordneter Ordner und Papierkorbstatus.

Lesen

Download a File from Google Drive

Lädt eine Datei anhand ihrer ID aus Google Drive herunter, mit optionalem Exportformat für Google Workspace-Dokumente.

Lesen

Export Google Workspace File

Exportiert ein Google Workspace-Dokument (Docs, Sheets, Slides) in einen angeforderten MIME-Typ wie PDF oder DOCX.

Lesen

Create File or Folder

Erstellt eine neue Datei oder einen neuen Ordner in Google Drive, mit Unterstützung für die reine Metadaten-Erstellung und den Datei-Upload mit Inhalt.

Schreiben

Create a File from Text

Erstellt eine neue Datei in Google Drive aus bereitgestelltem Textinhalt, mit optionaler Konvertierung in Google Workspace-Formate.

Schreiben

Create a Folder

Erstellt einen neuen Ordner in Google Drive, optional innerhalb eines vorhandenen übergeordneten Ordners.

Schreiben

Upload File

Lädt eine Datei (max. 5 MB) zu Google Drive hoch und platziert sie im angegebenen Ordner oder im Stammverzeichnis.

Schreiben

Upload File from URL to Drive

Ruft eine Datei von einer öffentlichen URL ab und lädt sie direkt in Google Drive hoch.

Schreiben

Upload/Update File Content

Ersetzt den Inhalt einer bestehenden Datei in Google Drive durch neuen Inhalt.

Schreiben

Edit File

Aktualisiert eine bestehende Textdatei in Google Drive, indem ihr gesamter Inhalt überschrieben wird (max. 10 MB).

Lesen

Move File

Verschiebt eine Datei von einem Ordner in einen anderen in Google Drive.

Lesen

Copy File with Advanced Options

Erstellt eine Kopie einer Datei mit optionalen Aktualisierungen, die mittels Patch-Semantik angewendet werden.

Lesen

Create Shortcut to File/Folder

Erstellt eine Verknüpfung zu einem vorhandenen Drive-Element von einem anderen Speicherort aus, ohne es zu duplizieren.

Schreiben

Create Permission

Teilt eine Datei oder einen Ordner mit einem Benutzer, einer Gruppe oder einer Domain, indem eine neue Berechtigung erstellt wird.

Schreiben

Create Permissions Batch

Erstellt mehrere Freigabeberechtigungen für Dateien oder geteilte Ablagen in einer einzigen Batch-Anfrage.

Schreiben

List Permissions

Ruft alle Berechtigungen ab, die mit einer bestimmten Datei oder geteilten Ablage verknüpft sind.

Lesen

Update Permission

Ändert eine bestehende Freigabeberechtigung für eine Datei oder geteilte Ablage.

Schreiben

Create Comment

Erstellt einen Kommentar zu einer Google Drive-Datei.

Schreiben

List Comments

Listet alle Kommentare zu einer Datei in Google Drive mit Paginierung auf.

Lesen

Update Comment

Aktualisiert den Inhalt eines bestehenden Kommentars zu einer Google Drive-Datei.

Schreiben

Create Reply

Erstellt eine Antwort auf einen Kommentar zu einer Google Drive-Datei.

Schreiben

List File Revisions

Listet die Metadaten des Revisionsverlaufs einer Datei in Google Drive auf.

Lesen

Create Shared Drive

Erstellt eine neue geteilte Ablage für die Teamzusammenarbeit.

Schreiben

List Shared Drives

Listet alle geteilten Ablagen auf, auf die der authentifizierte Benutzer zugreifen kann.

Lesen

Untrash File

Stellt eine Datei aus dem Papierkorb wieder her.

Schreiben

Get About

Ruft Informationen über den Benutzer, sein Drive-Speicherkontingent und die Systemfunktionen ab.

Lesen

Delete Permission

Widerruft eine Freigabeberechtigung für eine Datei. Diese Aktion ist unwiderruflich.

⚠️ Destruktiv

Trash File

Verschiebt eine Datei oder einen Ordner in den Papierkorb (weiche Löschung, wiederherstellbar).

⚠️ Destruktiv

Delete Folder or File

Löscht eine Datei oder einen Ordner dauerhaft aus Google Drive. Diese Aktion ist unwiderruflich.

⚠️ Destruktiv

Empty Trash

Löscht dauerhaft und unwiderruflich alle Dateien im Papierkorb des Google Drive-Kontos des Benutzers.

⚠️ Destruktiv

Anwendungsfälle

  • Dateien bei Bedarf finden und abrufen. Durchsuche dein Google Drive nach Name, Typ oder Inhalt und bringe Dateimetadaten oder -inhalte direkt in eine Goodweek-Unterhaltung, ohne die Drive-Oberfläche zu öffnen.

  • Dateien in Drive hochladen und organisieren. Lade neue Dateien in einen bestimmten Ordner hoch, erstelle Ordnerstrukturen oder verschiebe vorhandene Dateien zwischen Speicherorten direkt aus Goodweek.

  • Dateien mit bestimmten Personen oder Teams teilen. Erteile oder aktualisiere Freigabeberechtigungen für Dateien und Ordner direkt aus Goodweek, ohne die Drive-Einstellungen manuell zu öffnen.

  • Google Workspace-Dokumente exportieren. Exportiere ein Google Doc, Sheet oder Slide direkt aus Goodweek als PDF oder in ein anderes Format zum Teilen oder Archivieren.


Fehlerbehebung

„Fehler 400: admin_policy_enforced" beim Verbinden

Der Administrator deiner Organisation hat den Zugriff von Drittanbieter-Apps eingeschränkt. Die umfassenden Dateizugriffsbereiche von Google Drive machen dies besonders häufig. Nur ein Google Workspace-Superadministrator kann dies durch Befolgen von Szenario 2 oben beheben.

Integration in Goodweek nicht sichtbar

Stelle sicher, dass dein Organisationsadministrator die Google-Drive-Integration im Goodweek Admin-Panel im Tab Integrationen aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?