Google Sheets
Tilkoblingen skjer på samme måte som med andre Google-kontoer i Siesta AI (OAuth).
Oversikt
Dette dokumentet beskriver tilgjengelige integrasjoner med Google-tjenester:
- GoogleSearch (Custom Search JSON API)
- GoogleSheets (operasjoner på regneark)
Integrasjonene er designet som deterministiske, tilstandsløse operasjoner egnet for automatisering, rapportering og datarørledninger.
1. Google Search Integrasjon
Tjenestenavn
GoogleSearch
Operasjoner
Søk
Beskrivelse
Utfører søk ved hjelp av Google Custom Search JSON API.
Inngangsparametere
| Parameter | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
| query | String | Ja | Søkeforespørsel sendt til Google API. |
Atferd
- Returnerer resultater i henhold til konfigurasjonen av Custom Search Engine (CSE).
- Respekterer grenser og kvoter for Google API.
- Utfører ingen etterfølgende tolkning eller filtrering av resultater.
Typisk bruk
- Markedsanalyse
- Merkeovervåking
- Automatisert forskning
- Berikelse av data (enrichment)
2. Google Sheets Integrasjon
Tjenestenavn
GoogleSheets
Beskrivelse
Integrasjonen gjør det mulig å opprette, søke etter og oppdatere Google-regneark. Den brukes som et lett datalager eller eksportmål for automatiserte prosesser.
2.1 CreateSheetAsync
Beskrivelse
Oppretter et nytt Google-regneark med spesifiserte kolonner.
Inngangsparametere
| Parameter | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
| name | String | Ja | Navn på regnearket. |
| columnNames | String | Ja | Liste over kolonnenavn adskilt med komma. |
Atferd
- Hvis regnearket med det gitte navnet ikke eksisterer, opprettes det.
- Kolonnene initialiseres i første rad.
Typisk bruk
- Initialisering av rapporter
- Forberedelse av datastruktur for påfølgende skriving
2.2 GetSheetAsync
Beskrivelse
Søker etter eksisterende Google-regneark etter navn.
Inngangsparametere
| Parameter | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
| name | String | Ja | Navn på regnearket. |
Atferd
- Returnerer metadata for regnearket.
- Hvis regnearket ikke eksisterer, mislykkes operasjonen.
2.3 UpdateSheetAsync
Beskrivelse
Erstatter innholdet i et eksisterende regneark med data i CSV-format.
Inngangsparametere
| Parameter | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
| name | String | Ja | Navn på regnearket. |
| csvContent | String | Ja | CSV-data for skriving. Hvis feltet inneholder komma, må det være i anførselstegn. |
Atferd
- Erstatter fullstendig eksisterende innhold.
- Utfører ingen validering av datatyper.
- Ansvar for riktig CSV-format ligger hos den som kaller.
Typisk bruk
- Eksport av data
- Synkronisering av rapporter
- Automatisk overskriving av utdata fra rørledningen
Sikkerhetsnotater
- Integrasjonen kjører utelukkende via offisielle Google API.
- Ingen direkte påloggingsinformasjon blir eksponert.
- Tilgangsrettigheter styres på nivået til Google-kontoen eller tjenestekontoen.
Designbeslutninger
- Tilstandsløse operasjoner uten cache og delt tilstand.
- Eksplisitte navn: regnearket identifiseres med navn, ikke ID.
- Fail-fast tilnærming: inkonsistente data fører til feil.
Oppsummering
- GoogleSearch gir deterministisk søk gjennom Google Custom Search JSON API.
- GoogleSheets dekker opprettelse, søk og oppdatering av regneark.
- Dataformat og rettigheter er fullt ansvar for det kallende systemet.