Hop til hovedindhold

Google Docs

Forbindelsen foregår på samme måde som med andre Google-konti i Siesta AI (OAuth 2.0).
OAuth-login og samtykke-skærm i Google-kontoen kan variere afhængigt af kontotype, domænepolitik og tilgængelige tilladelser.

Oversigt

Dette dokument beskriver integrationen af GoogleDocs til arbejde med dokumenter i Google Workspace.

Integration er velegnet til:

  • læsning af indholdet i dokumenter til agenter og workflows,
  • automatiseret oprettelse af dokumenter,
  • opdatering af indholdet i dokumenter i interne processer.

Tilføj forbindelse

1. Tilslutning af Google Docs i Siesta AI

  1. I sektionen Forbindelser klik på Add Connection.
  2. Vælg Google-forbindelsen i udvalget af forbindelser.
  3. Log ind med din Google-konto.
  4. Bekræft de ønskede tilladelser (scopes) for Google Docs.
  5. I detaljerne for forbindelsen kan du justere adgangen og omfanget af tilladte funktioner (scopes/policies).
    Detalje om forbindelse og scopes

2. Google Docs Integration

Tjenestens navn

GoogleDocs

Beskrivelse

Integration muliggør oprettelse, indlæsning og opdatering af Google-dokumenter via en autoriseret Google-konto.

2.1 CreateDocumentAsync

Beskrivelse
Opretter et nyt Google-dokument.

Indgangsparametre

ParameterTypeObligatoriskBeskrivelse
titleStringJaDokumentets titel.
contentStringNejIndledende tekstindhold i dokumentet.

Adfærd

  • Hvis content er givet, skrives det til det nyoprettede dokument.
  • Udgiften er identifikatoren og metadata for det nye dokument.

Typisk brug

  • Generering af rapporter
  • Oprettelse af dokumenter fra skabeloner

2.2 GetDocumentAsync

Beskrivelse
Indlæser et eksisterende Google-dokument baseret på ID.

Indgangsparametre

ParameterTypeObligatoriskBeskrivelse
documentIdStringJaID for det ønskede dokument.

Adfærd

  • Returnerer metadata og indholdet af dokumentet i henhold til kontoens tilladelser.
  • Hvis dokumentet ikke eksisterer eller ikke er tilgængeligt, mislykkes operationen.

2.3 UpdateDocumentAsync

Beskrivelse
Opdaterer indholdet af et eksisterende dokument.

Indgangsparametre

ParameterTypeObligatoriskBeskrivelse
documentIdStringJaID for dokumentet, der skal opdateres.
contentStringJaNyt indhold, der skal skrives.

Adfærd

  • Opdateringen sker på det eksisterende dokument.
  • Omfanget og måden for ændringerne styres af tilladelserne fra den tilsluttede Google-konto.

Typisk brug

  • Opdatering af driftsdokumenter
  • Tilføjelse af output fra workflows
  • Synkronisering af indhold mellem systemer

Sikkerhedsnoter

  • Integration kører via det officielle Google API.
  • Adgang styres via OAuth 2.0 og scopes givet af brugeren.
  • Det anbefales at anvende princippet om minimale tilladelser og regelmæssigt revidere scopes.

Designbeslutninger

  • Alle operationer udføres på en specifik autoriseret Google-konto.
  • Tilladelser til dokumenter arves fra Google Workspace-deling.
  • Manglende tilladelser eller ikke-eksisterende dokument returnerer en fejl med det samme (fail-fast).

Resumé

  • GoogleDocs-forbindelsen muliggør oprettelse, læsning og redigering af dokumenter i Google Docs.
  • Forbindelsen er baseret på OAuth og administration af scopes.
  • Integration er velegnet til automatiserede dokumentations- og rapporteringsscenarier i agenter og workflows.