Google Sheets Connector
Propojení probíhá stejně jako u ostatních Google účtů v Siesta AI (OAuth).
Přehled
Tento dokument popisuje dostupné integrace se službami Google:
- GoogleSearch (Custom Search JSON API)
- GoogleSheets (operace nad spreadsheety)
Integrace jsou navrženy jako deterministické, bezstavové operace vhodné pro automatizaci, reporting a datové pipeline.
1. Google Search Integration
Název služby
GoogleSearch
Operace
Search
Popis
Provádí vyhledávání pomocí Google Custom Search JSON API.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| query | String | Ano | Vyhledávací dotaz předaný Google API. |
Chování
- Vrací výsledky dle konfigurace Custom Search Engine (CSE).
- Respektuje limity a kvóty Google API.
- Neprovádí žádnou následnou interpretaci nebo filtrování výsledků.
Typické použití
- Analýza trhu
- Monitoring značek
- Automatizovaný research
- Obohacení dat (enrichment)
2. Google Sheets Integration
Název služby
GoogleSheets
Popis
Integrace umožňuje vytváření, vyhledávání a aktualizaci Google Spreadsheetů. Používá se jako lehké datové úložiště nebo exportní cíl pro automatizované procesy.
2.1 CreateSheetAsync
Popis
Vytvoří nový Google Spreadsheet se specifikovanými sloupci.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| name | String | Ano | Název Spreadsheetu. |
| columnNames | String | Ano | Seznam názvů sloupců oddělených čárkou. |
Chování
- Pokud spreadsheet s daným názvem neexistuje, je vytvořen.
- Sloupce jsou inicializovány v prvním řádku.
Typické použití
- Inicializace reportů
- Příprava datové struktury pro následný zápis
2.2 GetSheetAsync
Popis
Vyhledá existující Google Spreadsheet podle názvu.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| name | String | Ano | Název Spreadsheetu. |
Chování
- Vrací metadata spreadsheetu.
- Pokud spreadsheet neexistuje, operace selže.
2.3 UpdateSheetAsync
Popis
Nahradí obsah existujícího Spreadsheetu daty ve formátu CSV.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| name | String | Ano | Název Spreadsheetu. |
| csvContent | String | Ano | CSV data k zápisu. Pokud pole obsahuje čárku, musí být v uvozovkách. |
Chování
- Kompletně nahrazuje existující obsah.
- Neprovádí validaci datového typu.
- Odpovědnost za správný CSV formát je na volajícím.
Typické použití
- Export dat
- Synchronizace reportů
- Automatické přepisování výstupů pipeline
Bezpečnostní poznámky
- Integrace běží výhradně přes oficiální Google API.
- Žádné přímé přihlašovací údaje nejsou vystavovány.
- Přístupová práva jsou řízena na úrovni Google účtu nebo service accountu.
Designová rozhodnutí
- Bezstavové operace bez cache a sdíleného stavu.
- Explicitní názvy: spreadsheet je identifikován jménem, ne ID.
- Fail-fast přístup: nekonzistentní data vedou k chybě.
Shrnutí
- GoogleSearch poskytuje deterministické vyhledávání přes Google Custom Search JSON API.
- GoogleSheets pokrývá vytvoření, dohledání a aktualizaci spreadsheetů.
- Formát dat a oprávnění jsou plně v odpovědnosti volajícího systému.