Google Docs
La connexion se fait de la même manière que pour les autres comptes Google dans Siesta AI (OAuth 2.0).
L'écran de connexion OAuth et l'écran de consentement dans le compte Google peuvent varier en fonction du type de compte, de la politique de domaine et des autorisations disponibles.
Aperçu
Ce document décrit l'intégration de GoogleDocs pour travailler avec des documents dans Google Workspace.
L'intégration est adaptée pour :
- lire le contenu des documents pour les agents et les workflows,
- créer des documents de manière automatisée,
- mettre à jour le contenu des documents dans le cadre de processus internes.
1. Connexion Google Docs dans Siesta AI
- Dans la section Connexions, clique sur Add Connection.
- Dans la sélection des connecteurs, choisis la connexion Google.
- Connecte-toi avec ton compte Google.
- Confirme les autorisations requises (scopes) pour Google Docs.
- Dans le détail de la connexion, tu peux modifier l'accès et l'étendue des fonctionnalités autorisées (scopes/policies).
2. Intégration Google Docs
Nom du service
GoogleDocs
Description
L'intégration permet de créer, charger et mettre à jour des documents Google via un compte Google autorisé.
2.1 CreateDocumentAsync
Description
Crée un nouveau document Google.
Paramètres d'entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| title | String | Oui | Titre du document. |
| content | String | Non | Contenu textuel initial du document. |
Comportement
- Si
contentest fourni, il sera écrit dans le document nouvellement créé. - La sortie est l'identifiant et les métadonnées du nouveau document.
Utilisation typique
- Génération de rapports
- Création de documents à partir de modèles
2.2 GetDocumentAsync
Description
Charge un document Google existant par ID.
Paramètres d'entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| documentId | String | Oui | ID du document cible. |
Comportement
- Retourne les métadonnées et le contenu du document selon les autorisations du compte.
- Si le document n'existe pas ou n'est pas accessible, l'opération échoue.
2.3 UpdateDocumentAsync
Description
Met à jour le contenu d'un document existant.
Paramètres d'entrée
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| documentId | String | Oui | ID du document à modifier. |
| content | String | Oui | Nouveau contenu à écrire. |
Comportement
- La mise à jour se fait sur le document existant.
- L'étendue et la manière des modifications sont régies par les autorisations du compte Google connecté.
Utilisation typique
- Mise à jour de documents opérationnels
- Ajout de résultats de workflows
- Synchronisation du contenu entre systèmes
Remarques de sécurité
- L'intégration fonctionne via l'API officielle de Google.
- L'accès est contrôlé par OAuth 2.0 et les scopes accordés par l'utilisateur.
- Il est recommandé d'utiliser le principe du moindre privilège et de réviser régulièrement les scopes.
Décisions de conception
- Toutes les opérations se font sur un compte Google autorisé spécifique.
- Les autorisations des documents sont héritées du partage Google Workspace.
- Les autorisations manquantes ou un document inexistant renvoient une erreur immédiatement (fail-fast).
Résumé
- Le connecteur GoogleDocs permet de créer, lire et modifier des documents dans Google Docs.
- La connexion est basée sur OAuth et la gestion des scopes.
- L'intégration est adaptée pour des scénarios de documentation et de reporting automatisés dans les agents et les workflows.