Skip to main content

Google Docs

Koblingen skjer på samme måte som med andre Google-kontoer i Siesta AI (OAuth 2.0). OAuth-pålogging og samtykkeskjermbilde i Google-kontoen kan variere avhengig av kontotype, domenepolitikk og tilgjengelige tillatelser.

Oversikt​

Dette dokumentet beskriver integrasjonen av GoogleDocs for arbeid med dokumenter i Google Workspace.

Integrasjonen er egnet for:

  • lesing av innholdet i dokumenter for agenter og arbeidsflyter,
  • automatisert oppretting av dokumenter,
  • oppdatering av innholdet i dokumenter i interne prosesser.

Legge til tilkobling

1. Koble til Google Docs i Siesta AI​

  1. I seksjonen Tilkoblinger klikker du på Add Connection.
  2. I utvalget av koblinger velger du Google-tilkoblingen.
  3. Logg inn med Google-kontoen din.
  4. Bekreft de nødvendige tillatelsene (scopes) for Google Docs.
  5. I detaljene for tilkoblingen kan du justere tilgang og omfang av tillatte funksjoner (scopes/policies). Detaljert tilkobling og scopes

2. Google Docs Integrasjon​

Tjenestenavn​

GoogleDocs

Beskrivelse​

Integrasjonen gjør det mulig å opprette, hente og oppdatere Google-dokumenter via en autorisert Google-konto.

2.1 CreateDocumentAsync​

Beskrivelse
Oppretter et nytt Google-dokument.

Inngangsparametere

ParameterTypeObligatoriskBeskrivelse
titleStringJaTittelen på dokumentet.
contentStringNeiStarttekstinnholdet i dokumentet.

Atferd

  • Hvis content er gitt, skrives det til det nyopprettede dokumentet.
  • Utdata er identifikatoren og metadataene til det nye dokumentet.

Typisk bruk

  • Generering av rapporter
  • Oppretting av dokumenter fra maler

2.2 GetDocumentAsync​

Beskrivelse
Henter et eksisterende Google-dokument etter ID.

Inngangsparametere

ParameterTypeObligatoriskBeskrivelse
documentIdStringJaID til måldokumentet.

Atferd

  • Returnerer metadata og innholdet i dokumentet i henhold til kontotillatelser.
  • Hvis dokumentet ikke eksisterer eller ikke er tilgjengelig, mislykkes operasjonen.

2.3 UpdateDocumentAsync​

Beskrivelse
Oppdaterer innholdet i et eksisterende dokument.

Inngangsparametere

ParameterTypeObligatoriskBeskrivelse
documentIdStringJaID til dokumentet som skal oppdateres.
contentStringJaNytt innhold som skal skrives.

Atferd

  • Oppdateringen skjer på det eksisterende dokumentet.
  • Omfanget og måten endringer skjer på styres av tillatelsene til den tilkoblede Google-kontoen.

Typisk bruk

  • Oppdatering av driftsdokumenter
  • Skriving av utdata fra arbeidsflyt
  • Synkronisering av innhold mellom systemer

Sikkerhetsnotater​

  • Integrasjonen kjører via det offisielle Google API.
  • Tilgang styres via OAuth 2.0 og scopes tildelt av brukeren.
  • Det anbefales å bruke prinsippet om minimumstillatelser og regelmessig revidere scopes.

Designbeslutninger​

  • Alle operasjoner skjer på en spesifikk autorisert Google-konto.
  • Tillatelser til dokumenter arves fra Google Workspace-deling.
  • Manglende tillatelser eller ikke-eksisterende dokument returnerer en feil umiddelbart (fail-fast).

Oppsummering​

  • GoogleDocs-koblingen gjør det mulig å opprette, lese og redigere dokumenter i Google Docs.
  • Tilkoblingen er basert på OAuth og administrasjon av scopes.
  • Integrasjonen er egnet for automatiserte dokumentasjons- og rapporteringsscenarier i agenter og arbeidsflyter.