Google Docs
Il collegamento avviene come per gli altri account Google in Siesta AI (OAuth 2.0).
Il login OAuth e la schermata di consenso nell'account Google possono variare a seconda del tipo di account, della politica di dominio e dei permessi disponibili.
Panoramica
Questo documento descrive l'integrazione di GoogleDocs per lavorare con documenti in Google Workspace.
L'integrazione è adatta per:
- leggere il contenuto dei documenti per agenti e flussi di lavoro,
- creazione automatizzata di documenti,
- aggiornamento del contenuto dei documenti nell'ambito di processi interni.
1. Collegamento Google Docs in Siesta AI
- Nella sezione Collegamenti clicca su Add Connection.
- Nella selezione dei connettori, scegli il collegamento Google.
- Accedi con il tuo account Google.
- Conferma i permessi richiesti (scopes) per Google Docs.
- Nei dettagli del collegamento puoi modificare l'accesso e l'ambito delle funzioni consentite (scopes/policies).
2. Integrazione Google Docs
Nome del servizio
GoogleDocs
Descrizione
L'integrazione consente di creare, caricare e aggiornare documenti Google tramite un account Google autorizzato.
2.1 CreateDocumentAsync
Descrizione
Crea un nuovo documento Google.
Parametri di input
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| title | String | Sì | Titolo del documento. |
| content | String | No | Contenuto testuale iniziale del documento. |
Comportamento
- Se viene fornito
content, verrà scritto nel nuovo documento creato. - L'output è l'identificatore e i metadati del nuovo documento.
Utilizzo tipico
- Generazione di report
- Creazione di documenti da modelli
2.2 GetDocumentAsync
Descrizione
Carica un documento Google esistente in base all'ID.
Parametri di input
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| documentId | String | Sì | ID del documento di destinazione. |
Comportamento
- Restituisce metadati e contenuto del documento in base ai permessi dell'account.
- Se il documento non esiste o non è disponibile, l'operazione fallisce.
2.3 UpdateDocumentAsync
Descrizione
Aggiorna il contenuto di un documento esistente.
Parametri di input
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| documentId | String | Sì | ID del documento da modificare. |
| content | String | Sì | Nuovo contenuto da scrivere. |
Comportamento
- L'aggiornamento avviene su un documento esistente.
- L'ambito e il modo delle modifiche sono regolati dai permessi dell'account Google collegato.
Utilizzo tipico
- Aggiornamento di documenti operativi
- Aggiunta di output dai flussi di lavoro
- Sincronizzazione del contenuto tra sistemi
Note di sicurezza
- L'integrazione avviene tramite l'API ufficiale di Google.
- L'accesso è gestito tramite OAuth 2.0 e scopes concessi dall'utente.
- Si consiglia di utilizzare il principio dei permessi minimi e di rivedere regolarmente gli scopes.
Decisioni di design
- Tutte le operazioni avvengono su un account Google autorizzato specifico.
- I permessi sui documenti sono ereditati dalla condivisione di Google Workspace.
- Permessi mancanti o documenti inesistenti restituiscono immediatamente un errore (fail-fast).
Riepilogo
- Il connettore GoogleDocs consente di creare, leggere e modificare documenti in Google Docs.
- Il collegamento è basato su OAuth e gestione degli scopes.
- L'integrazione è adatta per scenari di documentazione e reporting automatizzati in agenti e flussi di lavoro.