Google Docs
Propojení probíhá stejně jako u ostatních Google účtů v Siesta AI (OAuth 2.0). OAuth přihlášení a consent obrazovka v Google účtu se může lišit podle typu účtu, doménové politiky a dostupných oprávnění.
Přehled
Tento dokument popisuje integraci GoogleDocs pro práci s dokumenty v Google Workspace.
Integrace je vhodná pro:
- čtení obsahu dokumentů pro agenty a workflows,
- automatizované vytváření dokumentů,
- aktualizaci obsahu dokumentů v rámci interních procesů.
1. Připojení Google Docs v Siesta AI
- V sekci Připojení klikni na Add Connection.
- Ve výběru konektorů vyber Google připojení.
- Přihlas se svým Google účtem.
- Potvrď požadovaná oprávnění (scopes) pro Google Docs.
- V detailu připojení můžeš upravit přístup a rozsah povolených funkcí (scopes/policies).
2. Google Docs Integration
Název služby
GoogleDocs
Popis
Integrace umožňuje vytvářet, načítat a aktualizovat Google dokumenty přes autorizovaný Google účet.
2.1 CreateDocumentAsync
Popis
Vytvoří nový Google dokument.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| title | String | Ano | Název dokumentu. |
| content | String | Ne | Počáteční textový obsah dokumentu. |
Chování
- Pokud je předán
content, zapíše se do nově vytvořeného dokumentu. - Výstupem je identifikátor a metadata nového dokumentu.
Typické použití
- Generování reportů
- Zakládání dokumentů ze šablon
2.2 GetDocumentAsync
Popis
Načte existující Google dokument podle ID.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| documentId | String | Ano | ID cílového dokumentu. |
Chování
- Vrací metadata a obsah dokumentu dle oprávnění účtu.
- Pokud dokument neexistuje nebo není dostupný, operace selže.
2.3 UpdateDocumentAsync
Popis
Aktualizuje obsah existujícího dokumentu.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| documentId | String | Ano | ID dokumentu, který se má upravit. |
| content | String | Ano | Nový obsah určený k zápisu. |
Chování
- Aktualizace probíhá nad existujícím dokumentem.
- Rozsah a způsob změn se řídí oprávněními připojeného Google účtu.
Typické použití
- Aktualizace provozních dokumentů
- Dopisování výstupů z workflow
- Synchronizace obsahu mezi systémy
Bezpečnostní poznámky
- Integrace běží přes oficiální Google API.
- Přístup je řízen přes OAuth 2.0 a scopes udělené uživatelem.
- Doporučuje se používat princip minimálních oprávnění a pravidelně revidovat scopes.
Designová rozhodnutí
- Veškeré operace probíhají nad konkrétním autorizovaným Google účtem.
- Oprávnění k dokumentům se dědí z Google Workspace sdílení.
- Chybějící oprávnění nebo neexistující dokument vrací chybu okamžitě (fail-fast).
Shrnutí
- GoogleDocs konektor umožňuje vytvářet, číst a upravovat dokumenty v Google Docs.
- Připojení je založené na OAuth a správě scopes.
- Integrace je vhodná pro automatizované dokumentační a reportingové scénáře v agentech a workflows.