Google Drive

Indexez vos documents Google Drive pour enrichir les réponses de l’assistant.

Prérequis

• Accès admin Google Workspace.
• Un compte de service avec délégation domaine.
• Le fichier de clés JSON correspondant (client_email, private_key, etc.).
• Les scopes à autoriser :
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.metadata.readonly

Créer le compte de service

1. Rendez-vous sur la console Google Cloud.
2. Créez un projet (ou réutilisez-en un dédié aux intégrations).
3. IAM & Admin → Comptes de service → Créer.
4. Téléchargez la clé JSON.

Autoriser la délégation domaine

1. Dans l’admin console Google (https://admin.google.com), ouvrez Sécurité → Contrôles des API.
2. Cliquez sur Gérer la délégation au niveau du domaine.
3. Ajoutez un nouvel ID client (l’ID du compte de service) avec les scopes ci-dessus.

Configuration dans Hestyna

1. Catalogue → Intégrations → Google Drive.
2. Collez le JSON de la clé.
3. Optionnel : ajoutez un dossier racine pour limiter l’indexation.
4. Testez la connexion.

Créer un index Drive

1. Connaissance → Indexes → sélectionnez Google Drive.
2. Indiquez les dossiers ou partages (folders, drives).
3. Lancez la synchronisation.

Bonnes pratiques

• Utilisez un compte de service distinct par périmètre sensible.
• Nettoyez les documents obsolètes pour réduire le volume.
• Ajoutez des tags ({"confidential": true}) pour gérer les restrictions.

Maintenance

• Les clés JSON n’expirent pas mais renouvelez-les en cas de rotation de clefs.
• Surveillez les quotas d’API Drive (10 requêtes/s par utilisateur par défaut).
• Activez les alertes d’échec dans Hestyna.

Dépannage

Erreur	Solution
insufficient permissions	Vérifiez la délégation domaine et les scopes.
Documents manquants	Partagez les dossiers avec le compte de service ou ajoutez le drive partagé.
Clé invalide	Regénérez la clé JSON dans la console GCP.

Voir aussi : Publier la connaissance