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.

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

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
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| title | String | Ja | Dokumentets titel. |
| content | String | Nej | Inledande textinnehåll för dokumentet. |
Beteende
- Om
contentanges, 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
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| documentId | String | Ja | ID 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
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| documentId | String | Ja | ID för dokumentet som ska ändras. |
| content | String | Ja | Nytt 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.