Google Docs
Die Verbindung erfolgt wie bei anderen Google-Konten in Siesta AI (OAuth 2.0). Die OAuth-Anmeldung und der Zustimmungsbildschirm im Google-Konto können je nach Kontotyp, Domainrichtlinie und verfügbaren Berechtigungen variieren.
Übersicht
Dieses Dokument beschreibt die Integration von GoogleDocs zur Arbeit mit Dokumenten in Google Workspace.
Die Integration ist geeignet für:
- das Lesen von Dokumenteninhalten für Agenten und Workflows,
- die automatisierte Erstellung von Dokumenten,
- die Aktualisierung von Dokumenteninhalten im Rahmen interner Prozesse.
1. Verbindung Google Docs in Siesta AI
- Klicke im Abschnitt Verbindungen auf Add Connection.
- Wähle im Auswahlmenü die Google-Verbindung aus.
- Melde dich mit deinem Google-Konto an.
- Bestätige die erforderlichen Berechtigungen (scopes) für Google Docs.
- Im Detail der Verbindung kannst du den Zugriff und den Umfang der erlaubten Funktionen (scopes/policies) anpassen.
2. Google Docs Integration
Dienstname
GoogleDocs
Beschreibung
Die Integration ermöglicht das Erstellen, Laden und Aktualisieren von Google-Dokumenten über ein autorisiertes Google-Konto.
2.1 CreateDocumentAsync
Beschreibung
Erstellt ein neues Google-Dokument.
Eingabeparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| title | String | Ja | Titel des Dokuments. |
| content | String | Nein | Anfangstextinhalt des Dokuments. |
Verhalten
- Wenn
contentübergeben wird, wird dieser in das neu erstellte Dokument geschrieben. - Die Ausgabe ist die Kennung und die Metadaten des neuen Dokuments.
Typische Verwendung
- Generierung von Berichten
- Erstellung von Dokumenten aus Vorlagen
2.2 GetDocumentAsync
Beschreibung
Lädt ein vorhandenes Google-Dokument anhand der ID.
Eingabeparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| documentId | String | Ja | ID des Ziel-Dokuments. |
Verhalten
- Gibt die Metadaten und den Inhalt des Dokuments gemäß den Berechtigungen des Kontos zurück.
- Wenn das Dokument nicht existiert oder nicht verfügbar ist, schlägt die Operation fehl.
2.3 UpdateDocumentAsync
Beschreibung
Aktualisiert den Inhalt eines vorhandenen Dokuments.
Eingabeparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| documentId | String | Ja | ID des Dokuments, das bearbeitet werden soll. |
| content | String | Ja | Neuer Inhalt, der geschrieben werden soll. |
Verhalten
- Die Aktualisierung erfolgt über das vorhandene Dokument.
- Der Umfang und die Art der Änderungen richten sich nach den Berechtigungen des verbundenen Google-Kontos.
Typische Verwendung
- Aktualisierung von Betriebsdokumenten
- Ergänzung von Ausgaben aus Workflows
- Synchronisierung von Inhalten zwischen Systemen
Sicherheitsnotizen
- Die Integration erfolgt über die offizielle Google API.
- Der Zugriff wird über OAuth 2.0 und vom Benutzer erteilte Scopes gesteuert.
- Es wird empfohlen, das Prinzip der minimalen Berechtigungen zu verwenden und die Scopes regelmäßig zu überprüfen.
Designentscheidungen
- Alle Operationen erfolgen über ein bestimmtes autorisiertes Google-Konto.
- Berechtigungen für Dokumente werden von der Google Workspace-Freigabe geerbt.
- Fehlende Berechtigungen oder nicht existierende Dokumente führen sofort zu einem Fehler (fail-fast).
Zusammenfassung
- Der GoogleDocs-Connector ermöglicht das Erstellen, Lesen und Bearbeiten von Dokumenten in Google Docs.
- Die Verbindung basiert auf OAuth und der Verwaltung von Scopes.
- Die Integration ist geeignet für automatisierte Dokumentations- und Berichtsszenarien in Agenten und Workflows.