Google Sheets

Prepojenie prebieha rovnako ako u ostatných Google účtov v Siesta AI (OAuth).

Prehľad

Tento dokument popisuje dostupné integrácie so službami Google:

• GoogleSearch (Custom Search JSON API)
• GoogleSheets (operácie nad spreadsheetmi)

Integrácie sú navrhnuté ako deterministické, bezstavové operácie vhodné na automatizáciu, reporting a dátové pipeline.

1. Google Search Integrácia

Názov služby

GoogleSearch

Operácie

Search

Popis
Vykonáva vyhľadávanie pomocou Google Custom Search JSON API.

Vstupné parametre

Parameter	Typ	Povinný	Popis
query	String	Áno	Vyhľadávací dotaz odoslaný Google API.

Správanie

• Vracia výsledky podľa konfigurácie Custom Search Engine (CSE).
• Respektuje limity a kvóty Google API.
• Nevykonáva žiadnu následnú interpretáciu alebo filtrovanie výsledkov.

Typické použitie

• Analýza trhu
• Monitoring značiek
• Automatizovaný výskum
• Obohacovanie dát (enrichment)

2. Google Sheets Integrácia

Názov služby

GoogleSheets

Popis

Integrácia umožňuje vytváranie, vyhľadávanie a aktualizáciu Google Spreadsheetov. Používa sa ako ľahké dátové úložisko alebo exportný cieľ pre automatizované procesy.

2.1 CreateSheetAsync

Popis
Vytvorí nový Google Spreadsheet so špecifikovanými stĺpcami.

Vstupné parametre

Parameter	Typ	Povinný	Popis
name	String	Áno	Názov Spreadsheetu.
columnNames	String	Áno	Zoznam názvov stĺpcov oddelených čiarkou.

Správanie

• Ak spreadsheet s daným názvom neexistuje, je vytvorený.
• Stĺpce sú inicializované v prvom riadku.

Typické použitie

• Inicializácia reportov
• Príprava dátovej štruktúry pre následný zápis

2.2 GetSheetAsync

Popis
Vyhľadá existujúci Google Spreadsheet podľa názvu.

Vstupné parametre

Parameter	Typ	Povinný	Popis
name	String	Áno	Názov Spreadsheetu.

Správanie

• Vracia metadata spreadsheetu.
• Ak spreadsheet neexistuje, operácia zlyhá.

2.3 UpdateSheetAsync

Popis
Nahradí obsah existujúceho Spreadsheetu dátami vo formáte CSV.

Vstupné parametre

Parameter	Typ	Povinný	Popis
name	String	Áno	Názov Spreadsheetu.
csvContent	String	Áno	CSV dáta na zápis. Ak pole obsahuje čiarku, musí byť v úvodzovkách.

Správanie

• Kompletné nahradenie existujúceho obsahu.
• Nevykonáva validáciu dátového typu.
• Zodpovednosť za správny CSV formát je na volajúcom.

Typické použitie

• Export dát
• Synchronizácia reportov
• Automatické prepísanie výstupov pipeline

Bezpečnostné poznámky

• Integrácia prebieha výhradne cez oficiálne Google API.
• Žiadne priame prihlasovacie údaje nie sú vystavované.
• Prístupové práva sú riadené na úrovni Google účtu alebo service accountu.

Dizajnové rozhodnutia

• Bezstavové operácie bez cache a zdieľaného stavu.
• Explicitné názvy: spreadsheet je identifikovaný menom, nie ID.
• Fail-fast prístup: nekonzistentné dáta vedú k chybe.

Zhrnutie

• GoogleSearch poskytuje deterministické vyhľadávanie cez Google Custom Search JSON API.
• GoogleSheets pokrýva vytvorenie, dohľadanie a aktualizáciu spreadsheetov.
• Formát dát a oprávnenia sú plne v zodpovednosti volajúceho systému.