Google Docs

Yhteys tapahtuu samalla tavalla kuin muiden Google-tilien kanssa Siesta AI:ssa (OAuth 2.0). OAuth-kirjautuminen ja suostumusnäyttö Google-tilillä voivat vaihdella tilin tyypin, verkkotunnuspolitiikan ja käytettävissä olevien oikeuksien mukaan.

Yhteenveto

Tämä asiakirja kuvaa GoogleDocs-integraatiota Google Workspace -dokumenttien käsittelyyn.

Integraatio on sopiva:

• asiakirjojen sisällön lukemiseen agenteille ja työnkuluille,
• asiakirjojen automaattiseen luomiseen,
• asiakirjojen sisällön päivittämiseen sisäisten prosessien puitteissa.

1. Google Docs -yhteyden luominen Siesta AI:ssa

1. Siirry kohtaan Yhteydet ja napsauta Add Connection.
2. Valitse liittimien valikosta Google-yhteys.
3. Kirjaudu sisään Google-tililläsi.
4. Vahvista pyydetyt oikeudet (scopes) Google Docsille.
5. Yhteyden yksityiskohdissa voit muokata pääsyä ja sallittujen toimintojen laajuutta (scopes/policies).

2. Google Docs -integraatio

Palvelun nimi

GoogleDocs

Kuvaus

Integraatio mahdollistaa Google-dokumenttien luomisen, lataamisen ja päivittämisen valtuutetun Google-tilin kautta.

2.1 CreateDocumentAsync

Kuvaus
Luo uusi Google-dokumentti.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
title	String	Kyllä	Asiakirjan nimi.
content	String	Ei	Asiakirjan alkuperäinen tekstisisältö.

Käyttäytyminen

• Jos content on annettu, se kirjoitetaan uuteen asiakirjaan.
• Tuloksena on uuden asiakirjan tunniste ja metatiedot.

Tyypillinen käyttö

• Raporttien luominen
• Asiakirjojen perustaminen malleista

2.2 GetDocumentAsync

Kuvaus
Lataa olemassa oleva Google-dokumentti ID:n perusteella.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
documentId	String	Kyllä	Kohdeasiakirjan ID.

Käyttäytyminen

• Palauttaa asiakirjan metatiedot ja sisällön tilin oikeuksien mukaan.
• Jos asiakirja ei ole olemassa tai ei ole saatavilla, operaatio epäonnistuu.

2.3 UpdateDocumentAsync

Kuvaus
Päivittää olemassa olevan asiakirjan sisältöä.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
documentId	String	Kyllä	ID asiakirjasta, jota on tarkoitus muokata.
content	String	Kyllä	Uusi sisältö, joka on tarkoitettu kirjoitettavaksi.

Käyttäytyminen

• Päivitys tapahtuu olemassa olevan asiakirjan päällä.
• Muutosten laajuus ja tapa määräytyvät liitetyn Google-tilin oikeuksien mukaan.

Tyypillinen käyttö

• Toimintasiakirjojen päivittäminen
• Työnkulkujen tulosten lisääminen
• Sisällön synkronointi järjestelmien välillä

Turvallisuusmuistutukset

• Integraatio toimii virallisen Google API:n kautta.
• Pääsyä hallitaan OAuth 2.0:n ja käyttäjän myöntämien scopesin kautta.
• Suositellaan käyttämään vähimmäisoikeuksien periaatetta ja tarkistamaan scopes säännöllisesti.

Suunnittelupäätökset

• Kaikki toiminnot tapahtuvat tietyn valtuutetun Google-tilin kautta.
• Oikeudet asiakirjoihin periytyvät Google Workspace -jakamisesta.
• Puuttuvat oikeudet tai olemattomat asiakirjat palauttavat virheen heti (fail-fast).

Yhteenveto

• GoogleDocs-liitin mahdollistaa asiakirjojen luomisen, lukemisen ja muokkaamisen Google Docsissa.
• Yhteys perustuu OAuth:iin ja scopesin hallintaan.
• Integraatio on sopiva automatisoituihin asiakirja- ja raportointiskenaarioihin agenteissa ja työnkuluissa.