Hoppa till huvudinnehåll

Google Docs

Anslutningen sker på samma sätt som för andra Google-konton i Siesta AI (OAuth 2.0). OAuth-inloggning och samtyckesskärm i Google-kontot kan variera beroende på kontotyp, domänpolicy och tillgängliga behörigheter.

Översikt

Detta dokument beskriver integrationen av GoogleDocs för att arbeta med dokument i Google Workspace.

Integrationen är lämplig för:

  • läsning av dokumentinnehåll för agenter och arbetsflöden,
  • automatiserad skapelse av dokument,
  • uppdatering av dokumentinnehåll inom interna processer.

Lägg till anslutning

1. Anslutning av Google Docs i Siesta AI

  1. I avsnittet Anslutningar klicka på Add Connection.
  2. I urvalet av anslutningar välj Google-anslutning.
  3. Logga in med ditt Google-konto.
  4. Bekräfta de begärda behörigheterna (scopes) för Google Docs.
  5. I anslutningsdetaljerna kan du justera åtkomst och omfattning av tillåtna funktioner (scopes/policies). Detalj av anslutning och scopes

2. Google Docs Integration

Tjänstens namn

GoogleDocs

Beskrivning

Integrationen möjliggör skapande, hämtning och uppdatering av Google-dokument via ett auktoriserat Google-konto.

2.1 CreateDocumentAsync

Beskrivning
Skapar ett nytt Google-dokument.

Inmatningsparametrar

ParameterTypObligatoriskBeskrivning
titleStringJaDokumentets titel.
contentStringNejInledande textinnehåll för dokumentet.

Beteende

  • Om content anges, skrivs det till det ny skapade dokumentet.
  • Utdata är identifieraren och metadata för det nya dokumentet.

Typisk användning

  • Generering av rapporter
  • Skapande av dokument från mallar

2.2 GetDocumentAsync

Beskrivning
Hämtar ett befintligt Google-dokument baserat på ID.

Inmatningsparametrar

ParameterTypObligatoriskBeskrivning
documentIdStringJaID för det mål-dokumentet.

Beteende

  • Returnerar metadata och innehåll för dokumentet enligt kontots behörigheter.
  • Om dokumentet inte finns eller inte är tillgängligt, misslyckas operationen.

2.3 UpdateDocumentAsync

Beskrivning
Uppdaterar innehållet i ett befintligt dokument.

Inmatningsparametrar

ParameterTypObligatoriskBeskrivning
documentIdStringJaID för dokumentet som ska ändras.
contentStringJaNytt innehåll avsett för skrivning.

Beteende

  • Uppdateringen sker på det befintliga dokumentet.
  • Omfattningen och sättet för ändringar styrs av behörigheterna för det anslutna Google-kontot.

Typisk användning

  • Uppdatering av driftsdokument
  • Tillägg av utdata från arbetsflöden
  • Synkronisering av innehåll mellan system

Säkerhetsnoteringar

  • Integrationen körs via officiära Google API:er.
  • Åtkomst styrs via OAuth 2.0 och scopes beviljade av användaren.
  • Det rekommenderas att använda principen om minimala behörigheter och regelbundet revidera scopes.

Designbeslut

  • Alla operationer utförs på ett specifikt auktoriserat Google-konto.
  • Behörigheter till dokument ärvda från Google Workspace-delning.
  • Saknade behörigheter eller icke-existerande dokument returnerar omedelbart ett fel (fail-fast).

Sammanfattning

  • GoogleDocs-anslutningen möjliggör skapande, läsning och redigering av dokument i Google Docs.
  • Anslutningen är baserad på OAuth och hantering av scopes.
  • Integrationen är lämplig för automatiserade dokumentations- och rapporteringsscenarier i agenter och arbetsflöden.