Google Sheets
Anslutningen sker på samma sätt som för andra Google-konton i Siesta AI (OAuth).
Översikt
Detta dokument beskriver tillgängliga integrationer med Google-tjänster:
- GoogleSearch (Custom Search JSON API)
- GoogleSheets (operationer på kalkylblad)
Integrationerna är utformade som deterministiska, statslösa operationer som är lämpliga för automatisering, rapportering och datarörledningar.
1. Google Search Integration
Tjänstnamn
GoogleSearch
Operationer
Sök
Beskrivning
Utför en sökning med hjälp av Google Custom Search JSON API.
Inmatningsparametrar
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| query | String | Ja | Sökfråga som skickas till Google API. |
Beteende
- Returnerar resultat enligt konfigurationen av Custom Search Engine (CSE).
- Respekterar begränsningar och kvoter för Google API.
- Utför ingen efterföljande tolkning eller filtrering av resultaten.
Typisk användning
- Marknadsanalys
- Övervakning av varumärken
- Automatiserad forskning
- Berikning av data
2. Google Sheets Integration
Tjänstnamn
GoogleSheets
Beskrivning
Integration möjliggör skapande, sökning och uppdatering av Google-kalkylblad. Används som ett lätt datalager eller exportmål för automatiserade processer.
2.1 CreateSheetAsync
Beskrivning
Skapar ett nytt Google-kalkylblad med specificerade kolumner.
Inmatningsparametrar
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| name | String | Ja | Namn på kalkylbladet. |
| columnNames | String | Ja | Lista med kolumnnamn separerade med kommatecken. |
Beteende
- Om kalkylbladet med det angivna namnet inte finns, skapas det.
- Kolumnerna initieras i den första raden.
Typisk användning
- Initiering av rapporter
- Förberedelse av datastruktur för efterföljande skrivning
2.2 GetSheetAsync
Beskrivning
Söker efter ett befintligt Google-kalkylblad baserat på namnet.
Inmatningsparametrar
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| name | String | Ja | Namn på kalkylbladet. |
Beteende
- Returnerar metadata för kalkylbladet.
- Om kalkylbladet inte finns, misslyckas operationen.
2.3 UpdateSheetAsync
Beskrivning
Ersätter innehållet i ett befintligt kalkylblad med data i CSV-format.
Inmatningsparametrar
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| name | String | Ja | Namn på kalkylbladet. |
| csvContent | String | Ja | CSV-data att skriva. Om fältet innehåller ett kommatecken, måste det vara inom citattecken. |
Beteende
- Ersätter helt det befintliga innehållet.
- Utför ingen validering av datatyp.
- Ansvarigheten för korrekt CSV-format ligger på den anropande parten.
Typisk användning
- Export av data
- Synkronisering av rapporter
- Automatisk överskrivning av utdata från rörledningar
Säkerhetsnoteringar
- Integrationerna körs uteslutande via officiella Google API.
- Inga direkta inloggningsuppgifter exponeras.
- Åtkomsträttigheter styrs på nivå av Google-konto eller servicekonto.
Designbeslut
- Stateless operationer utan cache och delad status.
- Explicita namn: kalkylblad identifieras med namn, inte ID.
- Fail-fast tillvägagångssätt: inkonsekventa data leder till fel.
Sammanfattning
- GoogleSearch erbjuder deterministisk sökning via Google Custom Search JSON API.
- GoogleSheets täcker skapande, sökning och uppdatering av kalkylblad.
- Dataformat och behörigheter ligger helt på den anropande systemets ansvar.