Google Sheets
Forbindelsen foregår på samme måde som med andre Google-konti i Siesta AI (OAuth).
Oversigt
Dette dokument beskriver de tilgængelige integrationer med Google-tjenester:
- GoogleSearch (Custom Search JSON API)
- GoogleSheets (operationer på regneark)
Integrationerne er designet som deterministiske, stateless operationer, der er velegnede til automatisering, rapportering og datarørledninger.
1. Google Search Integration
Tjenestenavn
GoogleSearch
Operationer
Search
Beskrivelse
Udfører søgninger ved hjælp af Google Custom Search JSON API.
Indgangsparametre
| Parameter | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| query | String | Ja | Søgeforespørgsel sendt til Google API. |
Adfærd
- Returnerer resultater i henhold til konfigurationen af Custom Search Engine (CSE).
- Respekterer grænser og kvoter for Google API.
- Udfører ingen efterfølgende fortolkning eller filtrering af resultaterne.
Typisk brug
- Markedsanalyse
- Overvågning af brands
- Automatiseret research
- Berigelse af data (enrichment)
2. Google Sheets Integration
Tjenestenavn
GoogleSheets
Beskrivelse
Integration muliggør oprettelse, søgning og opdatering af Google-regneark. Den bruges som et let datalager eller eksportmål for automatiserede processer.
2.1 CreateSheetAsync
Beskrivelse
Opretter et nyt Google-regneark med de specificerede kolonner.
Indgangsparametre
| Parameter | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| name | String | Ja | Navn på regnearket. |
| columnNames | String | Ja | Liste over kolonnenavne adskilt af komma. |
Adfærd
- Hvis regnearket med det angivne navn ikke eksisterer, oprettes det.
- Kolonnerne initialiseres i den første række.
Typisk brug
- Initialisering af rapporter
- Forberedelse af datastruktur til efterfølgende skrivning
2.2 GetSheetAsync
Beskrivelse
Søger efter et eksisterende Google-regneark efter navn.
Indgangsparametre
| Parameter | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| name | String | Ja | Navn på regnearket. |
Adfærd
- Returnerer metadata for regnearket.
- Hvis regnearket ikke eksisterer, mislykkes operationen.
2.3 UpdateSheetAsync
Beskrivelse
Erstatter indholdet af et eksisterende regneark med data i CSV-format.
Indgangsparametre
| Parameter | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| name | String | Ja | Navn på regnearket. |
| csvContent | String | Ja | CSV-data til skrivning. Hvis feltet indeholder et komma, skal det være i citationstegn. |
Adfærd
- Erstatning af eksisterende indhold helt.
- Udfører ingen validering af datatyper.
- Ansvarligheden for korrekt CSV-format ligger hos den kaldende part.
Typisk brug
- Dataeksport
- Synkronisering af rapporter
- Automatisk omskrivning af output fra rørledninger
Sikkerhedsnoter
- Integrationerne kører udelukkende via officielle Google API'er.
- Ingen direkte loginoplysninger offentliggøres.
- Adgangsrettigheder styres på niveauet for Google-kontoen eller servicekontoen.
Designbeslutninger
- Stateless operationer uden cache og delt tilstand.
- Eksplícite navne: regnearket identificeres ved navn, ikke ID.
- Fail-fast tilgang: inkonsistente data fører til fejl.
Resumé
- GoogleSearch tilbyder deterministisk søgning via Google Custom Search JSON API.
- GoogleSheets dækker oprettelse, søgning og opdatering af regneark.
- Dataformat og rettigheder er fuldt ud ansvaret for det kaldende system.