Google Sheets
Yhteys tapahtuu samalla tavalla kuin muiden Google-tilien kanssa Siesta AI:ssa (OAuth).
Yhteenveto
Tämä asiakirja kuvaa saatavilla olevat integraatiot Google-palveluiden kanssa:
- GoogleSearch (Custom Search JSON API)
- GoogleSheets (toiminnot taulukkolaskentataulukoissa)
Integraatiot on suunniteltu deterministisiksi, tilattomiksi toiminnoiksi, jotka sopivat automatisointiin, raportointiin ja tietoputkiin.
1. Google Search Integration
Palvelun nimi
GoogleSearch
Toiminnot
Haku
Kuvaus
Suorittaa haun Google Custom Search JSON API:n avulla.
Syöttöparametrit
| Parametri | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| query | Merkkijono | Kyllä | Hakukysely, joka annetaan Google API:lle. |
Käyttäytyminen
- Palauttaa tulokset Custom Search Engine (CSE) -konfiguraation mukaan.
- Kunnioittaa Google API:n rajoja ja kiintiöitä.
- Ei suorita mitään jälkikäsittelyä tai suodatusta tuloksille.
Tyypillinen käyttö
- Markkina-analyysi
- Brändien seuranta
- Automaattinen tutkimus
- Datan rikastaminen (enrichment)
2. Google Sheets Integration
Palvelun nimi
GoogleSheets
Kuvaus
Integraatio mahdollistaa Google-taulukkolaskentataulukoiden luomisen, hakemisen ja päivittämisen. Sitä käytetään kevyenä tietovarastona tai vientikohteena automatisoiduille prosesseille.
2.1 CreateSheetAsync
Kuvaus
Luo uusi Google-taulukkolaskentataulukko määritellyillä sarakkeilla.
Syöttöparametrit
| Parametri | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| name | Merkkijono | Kyllä | Taulukon nimi. |
| columnNames | Merkkijono | Kyllä | Sarakenimien luettelo, erotettuna pilkuilla. |
Käyttäytyminen
- Jos taulukkoa, jonka nimi on annettu, ei ole olemassa, se luodaan.
- Sarakkeet alustetaan ensimmäiselle riville.
Tyypillinen käyttö
- Raporttien alustaminen
- Tietorakenteen valmistelu myöhempää kirjoittamista varten
2.2 GetSheetAsync
Kuvaus
Hakee olemassa olevan Google-taulukkolaskentataulukon nimen perusteella.
Syöttöparametrit
| Parametri | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| name | Merkkijono | Kyllä | Taulukon nimi. |
Käyttäytyminen
- Palauttaa taulukon metatiedot.
- Jos taulukkoa ei ole olemassa, operaatio epäonnistuu.
2.3 UpdateSheetAsync
Kuvaus
Korvataan olemassa olevan taulukon sisältö CSV-muotoisilla tiedoilla.
Syöttöparametrit
| Parametri | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| name | Merkkijono | Kyllä | Taulukon nimi. |
| csvContent | Merkkijono | Kyllä | CSV-tiedot kirjoitettavaksi. Jos kenttä sisältää pilkun, se on oltava lainausmerkeissä. |
Käyttäytyminen
- Korvataan kokonaan olemassa oleva sisältö.
- Ei suorita tietotyypin validointia.
- Vastuu oikeasta CSV-muodosta on kutsujalla.
Tyypillinen käyttö
- Datan vienti
- Raporttien synkronointi
- Automaattinen putkilinjan tulosten uudelleenkirjoittaminen
Turvallisuusmuistiinpanot
- Integraatiot toimivat yksinomaan virallisten Google API:en kautta.
- Suoria kirjautumistietoja ei julkaista.
- Käyttöoikeudet hallitaan Google-tilin tai palvelutilin tasolla.
Suunnittelupäätökset
- Tilattomat toiminnot ilman välimuistia ja jaettua tilaa.
- Ilmoitetut nimet: taulukko tunnistetaan nimellä, ei ID:llä.
- Fail-fast-lähestymistapa: epäjohdonmukaiset tiedot johtavat virheeseen.
Yhteenveto
- GoogleSearch tarjoaa deterministisen haun Google Custom Search JSON API:n kautta.
- GoogleSheets kattaa taulukkolaskentataulukoiden luomisen, hakemisen ja päivittämisen.
- Tietomuoto ja käyttöoikeudet ovat täysin kutsuvan järjestelmän vastuulla.