Skip to content

SourceToAI.Docs-GoogleDrive.md

Latest commit

 

History

History
34 lines (26 loc) · 2.42 KB

SourceToAI.Docs-GoogleDrive.md

File metadata and controls

34 lines (26 loc) · 2.42 KB

Google Drive Sync Integration

SourceToAI bietet die Möglichkeit, nach einem erfolgreichen lokalen Export die generierten Markdown-Feeds automatisch in Google Drive hochzuladen.

Funktionsweise

  • Der Upload nutzt "In-Place Updates", d.h. der Zielordner für die Solution wird auf Google Drive einmalig erstellt und bleibt dann stabil (die Folder ID ändert sich nicht).
  • Bei jedem Lauf werden lediglich die vorhandenen .md-Dateien im Zielordner selektiv gelöscht und durch die neuen ersetzt. Dies gewährleistet persistente Folder IDs für die einfache Integration mit KI-Tools (z.B. Gemini Workspace Extension).
  • Am Ende des Synchronisationsvorgangs wird die stabile Google Drive Folder ID in der Konsole ausgegeben, damit sie direkt weiterverwendet werden kann.
  • Der verwendete OAuth-Scope (drive.file) stellt sicher, dass SourceToAI nur auf die von der App selbst erstellten Dateien und Ordner zugreifen kann, was maximale Sicherheit für deine restlichen privaten Daten bietet.
  • Parallele Verarbeitung: Um die Performance bei großen Projekten zu maximieren, werden Uploads und Löschvorgänge asynchron parallel ausgeführt. Eine integrierte Drosselung (Throttled Parallelism via SemaphoreSlim) begrenzt dabei die gleichzeitigen Anfragen auf maximal 5, um Rate-Limiting-Probleme ("429 Too Many Requests") der Google Drive API zu verhindern.

Setup-Anleitung

  1. Google Cloud Console: Erstelle ein neues Projekt und aktiviere die "Google Drive API".
  2. OAuth-Zustimmungsbildschirm: Richte den Zustimmungsbildschirm ein (User Type: External/Internal). Wähle als Scope .../auth/drive.file.
  3. Anmeldedaten: Erstelle "OAuth-Client-ID"-Anmeldedaten für den Anwendungstyp "Desktop-App".
  4. Client Secret speichern: Lade die JSON-Datei herunter (beginnt meist mit client_secret_...) und speichere sie in folgendem Pfad auf deinem lokalen Rechner: %LOCALAPPDATA%\GoogleDrive.CodeSync\ (Erstelle den Ordner, falls er noch nicht existiert).

Beim ersten Ausführen von SourceToAI mit aktiviertem Drive-Sync wird sich ein Browser-Fenster öffnen, in dem du die App einmalig autorisieren musst. Danach wird ein token.json im selben Verzeichnis abgelegt, das für künftige Uploads genutzt wird.

Konfiguration

In der appsettings.json kannst du die Funktion aktivieren und den Root-Ordnernamen in Drive anpassen:

{
    "GoogleDriveSync": {
        "Enabled": true,
        "TargetFolder": "Code"
    }
}