API-Konten: Google- und Microsoft-Verbindung

So legen Sie ein Google- oder Microsoft-365-Konto für Speicher- und Mailverbindungen an, autorisieren den Zugriff und trennen die Verbindung.

Das Menü API-Konten enthält die externen Konten, über die das System Google Drive, Gmail oder Speicher und Mail von Microsoft 365 erreicht. Nach dem Anlegen eines Kontos muss der Zugriff einmalig auf der Seite von Google oder Microsoft erlaubt werden.

Bevor Sie beginnen

  • Für ein Google-OAuth- oder Microsoft-Konto brauchen Sie Client-ID und Client-Secret aus der Entwicklerkonsole des Anbieters.
  • Bei Microsoft registrieren Sie die im Formular angezeigte Redirect-URI (Azure) GENAU so in der Azure-App; jede Abweichung führt zu einem Fehler.
  • Ein Google-Dienstkonto braucht die von Google heruntergeladene JSON-Datei mit den Anmeldedaten.

Konto anlegen und verbinden

  1. Öffnen Sie Stammdaten (Google / KI / WIP) → API-Konten und klicken Sie oben rechts auf die blaue Schaltfläche +.
  2. Geben Sie Kontoinhaber ein (1–255 Zeichen) und wählen Sie Anbieter (Google oder Microsoft) und Authentifizierungsart.
  3. Füllen Sie Client-ID (Pflicht) und Client-Secret aus; bei Microsoft auch Tenant und Scopes.
  4. Darf das Konto nur in einem Ordner arbeiten, tragen Sie den Pfad unter Stammordner (Einschränkung) ein; leer steht das ganze Laufwerk zur Verfügung.
  5. Bei einem Dienstkonto laden Sie die JSON-Datei unter Anmeldedaten hoch.
  6. Klicken Sie auf Speichern.
  7. Klicken Sie in der Liste in der Zeile des Kontos auf Verbindung. In einem neuen Fenster öffnet sich die Zustimmungsseite von Google oder Microsoft; melden Sie sich an und erlauben Sie den Zugriff. Bei Erfolg wird das Konto aktiv.

Verbindung verwalten

  • Die Schaltfläche Trennung deaktiviert das Konto und löscht das gespeicherte Zugriffstoken; neu verbinden Sie es mit Verbindung.
  • Bei einem Dienstkonto öffnet der Start die Drive-Verbindung und setzt das Konto aktiv.
  • Die Drive-Ordnersynchronisierung aktualisiert die Ordnerliste und meldet, wie viele Ordner eingefügt, aktualisiert und fehlerhaft waren.

Meldungen und Warnungen

  • „Warnung: Name fehlt!“ und „Warnung: Client-ID fehlt!“
  • „Es kann nur eine JSON-Datei hochgeladen werden!“ — „Diese Datei existiert bereits!“ (eine vorhandene Datei wird nicht überschrieben).
  • Bei Microsoft, wenn das Konto fehlt oder kein Microsoft-Anbieter ist: „Microsoft-Konto nicht gefunden“.
Die rote Papierkorb-Schaltfläche im Kopfbereich löscht das Konto ohne Prüfung: Sie schaut nicht, ob Dokumente oder Postfächer es verwenden. Stellen Sie vor dem Löschen sicher, dass nichts mehr auf dem Konto aufbaut.

Beispiel

Die Muster GmbH speichert ihre Dokumente im eigenen Google Drive, aber nur im Ordner „Freigabe“. Ein Google-OAuth-Konto „Muster Drive“ wird mit „Freigabe“ unter Stammordner (Einschränkung) angelegt, und der Administrator der Firma erlaubt den Zugriff über die Schaltfläche Verbindung. Ab dann listet, lädt und legt das System Unterordner nur in diesem Ordner an.