Connecteur Google Drive

Configuration du connecteur

Le connecteur Google Drive permet de synchroniser les documents accessibles par un compte de service Google vers Wikit Semantics.

Nom du champ	Format / Type	Obligatoire	Commentaire
Email du compte de service (serviceAccountEmail)	Email	✅	Adresse email du compte de service Google (ex: wikit-sync@mon-projet.iam.gserviceaccount.com)
Clé privée (key)	Texte long (clé PEM)	✅	Clé privée du compte de service (champ private_key du JSON de clé)
IDs de Shared Drives (sharedDriveIds)	Liste de textes	➖	Liste des IDs des espaces partagés à synchroniser. Si vide, tous les Shared Drives accessibles sont parcourus
Chemins à inclure (pathsToInclude)	Liste de textes	➖	Restreint la synchronisation à certains chemins (format: Drive/Dossier/Sous-dossier)
Chemins à exclure (pathsToExclude)	Liste de textes	➖	Exclut des chemins précis de la synchronisation
Types MIME à exclure (excludedMimeTypes)	Liste de textes	➖	Types MIME à ignorer (ex: image/png, application/zip)

💡 Les champs marqués ✅ sont obligatoires pour que le connecteur puisse fonctionner.

Prérequis

Avant de configurer le connecteur dans Wikit Connect :

1. Projet Google Cloud avec API Google Drive activée.
2. Compte de service dédié à la synchronisation.
3. Clé JSON du compte de service.
4. Droits de lecture sur les contenus Drive à synchroniser.

Obtenir les informations dans Google Cloud

1) Créer ou sélectionner le projet Google Cloud

1. Ouvrez Google Cloud Console.
2. Sélectionnez un projet existant ou créez un nouveau projet.

2) Activer l'API Google Drive

1. Allez dans APIs et services > Bibliothèque.
2. Recherchez Google Drive API.
3. Cliquez sur Activer.

3) Créer le compte de service

1. Allez dans IAM et administration > Comptes de service.
2. Cliquez sur Créer un compte de service.
3. Donnez un nom explicite (ex: wikit-google-drive-sync) puis validez.
4. Vous pouvez laisser les rôles Google Cloud vides pour ce besoin (l'accès réel se fait via le partage Drive).

4) Générer la clé JSON et récupérer les valeurs à saisir

1. Ouvrez le compte de service créé.
2. Allez dans l'onglet Clés.
3. Cliquez sur Ajouter une clé > Créer une clé > format JSON.
4. Téléchargez le fichier JSON.
5. Dans ce JSON :
   • client_email -> valeur à renseigner dans serviceAccountEmail
   • private_key -> valeur à renseigner dans key

5) Donner l'accès Google Drive au compte de service

1. Copiez l'adresse email du compte de service (client_email).
2. Dans Google Drive, partagez les dossiers/fichiers/Shared Drives avec cette adresse.
3. Donnez au minimum un droit Lecteur.

6) Récupérer les sharedDriveIds (optionnel)

1. Ouvrez un Shared Drive dans Google Drive.
2. Récupérez son identifiant dans l'URL.
3. Renseignez cet identifiant dans sharedDriveIds si vous voulez limiter le périmètre à certains Shared Drives.

7) Vérification rapide avant configuration

1. Vérifiez que l'API Google Drive est bien activée dans le bon projet.
2. Vérifiez que la clé JSON correspond au bon compte de service.
3. Vérifiez que le compte de service est bien partagé sur les contenus à indexer.

Fonctionnement du connecteur

Le connecteur Google Drive fonctionne en synchronisation intelligente (smart sync) :

• Détection des changements : il insère, met à jour ou supprime les documents en comparant l'état actuel de Google Drive avec l'état déjà indexé.
• Source scannée :
  • si des Shared Drives sont accessibles, le connecteur scanne ces espaces (ou ceux listés dans sharedDriveIds),
  • sinon, il scanne tous les fichiers accessibles au compte de service (ex: éléments partagés dans "Mon Drive").
• Filtres de chemin : pathsToInclude et pathsToExclude permettent de cibler finement les dossiers à indexer.
• Filtre de type MIME : excludedMimeTypes permet d'ignorer des types de fichiers spécifiques.
• Export Google Workspace :
  • Google Docs -> export .docx
  • Google Sheets -> export .xlsx
  • Google Drawings -> export .pdf
• Types non traités : certains types sont ignorés par le connecteur (ex: Google Forms, Google Sites, Google Maps, MP4, PPTX, MS Project).

FAQ

Comment trouver l'ID d'un Shared Drive ?

Ouvrez le Shared Drive dans Google Drive. L'ID est visible dans l'URL, après /drives/.

Exemple : https://drive.google.com/drive/folders/xxxxxxxx?driveId=0AEXEMPLEabcUk9PVA

L'ID attendu est généralement la valeur de driveId (ou l'identifiant visible après /drives/ selon l'URL affichée).

Quel format utiliser pour les chemins à inclure / exclure ?

Utilisez des chemins lisibles sans slash initial, par exemple : Equipe RH/PolitiquesDirection SI/Procédures/Run

Les chemins sont comparés par nom de dossier, avec prise en compte des sous-dossiers.

Pourquoi aucun document ne remonte alors que le test de connexion est OK ?

Vérifiez les points suivants :

1. Les fichiers/dossiers sont bien partagés avec l'email du compte de service.
2. Les sharedDriveIds configurés sont corrects et accessibles par ce compte.
3. Les filtres pathsToInclude, pathsToExclude ou excludedMimeTypes n'excluent pas tout le périmètre.
4. Les fichiers attendus ne font pas partie des types non pris en charge par le connecteur.