Google Sheets
Die Verbindung erfolgt wie bei anderen Google-Konten in Siesta AI (OAuth).
Übersicht
Dieses Dokument beschreibt die verfügbaren Integrationen mit Google-Diensten:
- GoogleSearch (Custom Search JSON API)
- GoogleSheets (Operationen über Tabellenkalkulationen)
Die Integrationen sind als deterministische, zustandslose Operationen konzipiert, die sich für Automatisierung, Reporting und Datenpipelines eignen.
1. Google Search Integration
Dienstname
GoogleSearch
Operationen
Suche
Beschreibung
Führt eine Suche mit dem Google Custom Search JSON API durch.
Eingabeparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| query | String | Ja | Suchanfrage, die an die Google API übergeben wird. |
Verhalten
- Gibt Ergebnisse gemäß der Konfiguration der benutzerdefinierten Suchmaschine (CSE) zurück.
- Achtet auf die Limits und Quoten der Google API.
- Führt keine nachfolgende Interpretation oder Filterung der Ergebnisse durch.
Typische Verwendung
- Marktanalyse
- Markenüberwachung
- Automatisierte Recherche
- Datenanreicherung
2. Google Sheets Integration
Dienstname
GoogleSheets
Beschreibung
Die Integration ermöglicht das Erstellen, Suchen und Aktualisieren von Google-Tabellenkalkulationen. Sie wird als leichtes Datenspeicher oder Exportziel für automatisierte Prozesse verwendet.
2.1 CreateSheetAsync
Beschreibung
Erstellt eine neue Google-Tabelle mit den angegebenen Spalten.
Eingabeparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | String | Ja | Name der Tabelle. |
| columnNames | String | Ja | Liste der Spaltennamen, durch Kommas getrennt. |
Verhalten
- Wenn eine Tabelle mit dem angegebenen Namen nicht existiert, wird sie erstellt.
- Die Spalten werden in der ersten Zeile initialisiert.
Typische Verwendung
- Initialisierung von Berichten
- Vorbereitung der Datenstruktur für nachfolgende Schreibvorgänge
2.2 GetSheetAsync
Beschreibung
Sucht eine vorhandene Google-Tabelle nach ihrem Namen.
Eingabeparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | String | Ja | Name der Tabelle. |
Verhalten
- Gibt Metadaten der Tabelle zurück.
- Wenn die Tabelle nicht existiert, schlägt die Operation fehl.
2.3 UpdateSheetAsync
Beschreibung
Ersetzt den Inhalt einer vorhandenen Tabelle mit Daten im CSV-Format.
Eingabeparameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| name | String | Ja | Name der Tabelle. |
| csvContent | String | Ja | CSV-Daten zum Schreiben. Wenn das Feld ein Komma enthält, muss es in Anführungszeichen stehen. |
Verhalten
- Ersetzt den vorhandenen Inhalt vollständig.
- Führt keine Validierung des Datentyps durch.
- Die Verantwortung für das korrekte CSV-Format liegt beim Aufrufer.
Typische Verwendung
- Datenexport
- Synchronisierung von Berichten
- Automatisches Überschreiben von Pipeline-Ausgaben
Sicherheitsnotizen
- Die Integration erfolgt ausschließlich über die offiziellen Google APIs.
- Es werden keine direkten Anmeldedaten offengelegt.
- Die Zugriffsrechte werden auf der Ebene des Google-Kontos oder des Dienstkontos verwaltet.
Designentscheidungen
- Zustandslose Operationen ohne Cache und gemeinsamen Zustand.
- Eindeutige Namen: Die Tabelle wird durch ihren Namen und nicht durch eine ID identifiziert.
- Fail-Fast-Ansatz: Inkonsistente Daten führen zu einem Fehler.
Zusammenfassung
- GoogleSearch bietet deterministische Suchen über das Google Custom Search JSON API.
- GoogleSheets deckt das Erstellen, Suchen und Aktualisieren von Tabellenkalkulationen ab.
- Das Datenformat und die Berechtigungen liegen vollständig in der Verantwortung des aufrufenden Systems.