Passer au contenu principal
Configurez et gérez la synchronisation entre un contenu Google Drive et Paradigm. Cette page contient le guide de configuration et les informations de référence pour le connecteur source Google Drive. Le connecteur source Google Drive récupère les données d’un dossier dans Google Drive. Les sous-dossiers sont inclus de manière récursive dans la synchronisation. Tous les fichiers du dossier spécifié et de tous les sous-dossiers seront considérés, excluant les types de fichiers non supportés ou trop volumineux.

​
Prérequis

  • Lien du dossier Drive - Le lien vers le dossier Google Drive à partir duquel vous voulez synchroniser les fichiers (inclut les fichiers situés dans les sous-dossiers)
  • Un projet GCP
  • Activer l’API Google Drive dans votre projet GCP
  • Clé de Compte de Service avec accès au dossier Google Drive que vous voulez synchroniser

​
Guide de Configuration

Le connecteur source Google Drive supporte l’authentification par Clé de Compte de Service.

​
Configurer la clé de compte de service

​
Créer un compte de service

  1. Ouvrez la page Comptes de Service dans votre console Google Cloud.
  2. Sélectionnez un projet existant, ou créez un nouveau projet.
  3. En haut de la page, cliquez sur + Créer un compte de service.
  4. Entrez un nom et une description pour le compte de service, puis cliquez sur Créer et Continuer.
  5. Sous Permissions du compte de service, sélectionnez les rôles à accorder au compte de service, puis cliquez sur Continuer. Nous recommandons le rôle Visualiseur.

​
Générer une clé

  1. Allez à la page Console API/Identifiants et cliquez sur l’adresse e-mail du compte de service que vous venez de créer.
  2. Dans l’onglet Clés, cliquez sur + Ajouter une clé, puis cliquez sur Créer une nouvelle clé.
  3. Sélectionnez JSON comme type de clé. Cela générera et téléchargera le fichier de clé JSON que vous utiliserez pour l’authentification. Cliquez sur Continuer.

​
Activer l’API Google Drive

  1. Allez à la page Console API/Bibliothèque.
  2. Assurez-vous d’avoir sélectionné le bon projet depuis le haut.
  3. Trouvez et sélectionnez l’API Google Drive.
  4. Cliquez sur ACTIVER.
Si votre dossier est visible par quiconque avec son lien, aucune action supplémentaire n’est nécessaire. Sinon, donnez l’accès à votre compte de service à votre dossier. Consultez cette vidéo pour savoir comment procéder.

​
Dans l’admin Paradigm

​
Configuration de la Source de Données

  1. Naviguez vers la section DATASOURCES dans votre interface d’administration Paradigm
  2. Créez une nouvelle Source de Données avec Type de source de données = Google Drive
  3. Ajoutez votre clé de compte de service Google Cloud au format JSON : 
{
  "type": "service_account",
  "project_id": "VOTRE_PROJECT_ID",
  "private_key_id": "VOTRE_PRIVATE_KEY",
  ...
}
  1. Pour Lien du Dossier, entrez le lien vers le dossier Google Drive. Pour obtenir le lien, naviguez vers le dossier que vous voulez synchroniser dans l’interface Google Drive, et copiez l’URL actuelle.
  2. Configurez le paramètre optionnel Date de Début qui marque une date et heure de début en UTC pour la réplication des données. Tous les fichiers qui n’ont pas été modifiés depuis cette date/heure spécifiée ne seront pas répliqués. Utilisez le sélecteur de date fourni (recommandé) ou entrez la date désirée de manière programmée au format YYYY-MM-DDTHH:mm:ssZ. Laisser ce champ vide répliquera les données de tous les fichiers qui n’ont pas été exclus par le Motif de Chemin et le Préfixe de Chemin.
  3. Cliquez sur Configurer la source et attendez que les tests se terminent.

​
Méthode d’Authentification

​
Authentification par Clé de Compte de Service

  • Utilise un fichier de clé JSON généré depuis la Console Google Cloud
  • Fournit un accès sécurisé aux dossiers Google Drive
  • Nécessite une attribution de rôle appropriée (rôle Visualiseur recommandé)
  • Le compte de service doit avoir accès au dossier Google Drive cible

​
Détails de Synchronisation des Fichiers

​
Contenu Inclus

  • Tous les fichiers dans le dossier spécifié
  • Fichiers dans tous les sous-dossiers (synchronisation récursive)
  • Seuls les types de fichiers supportés sont traités
  • Les fichiers dans les limites de taille sont inclus

​
Contenu Exclu

  • Les types de fichiers non supportés sont automatiquement exclus
  • Les fichiers qui dépassent les limites de taille sont ignorés
  • Les fichiers peuvent être filtrés en utilisant les paramètres Motif de Chemin et Préfixe de Chemin

​
Dépannage

​
Problèmes Courants

Erreurs d’Authentification
  • Vérifiez que la clé JSON du compte de service est correctement formatée
  • Assurez-vous que le compte de service a les permissions nécessaires
  • Vérifiez que l’API Google Drive est activée pour votre projet
Erreurs d’Accès Refusé
  • Confirmez que le compte de service a accès au dossier cible
  • Pour les dossiers privés, partagez explicitement le dossier avec l’e-mail du compte de service
  • Vérifiez les permissions du dossier et les paramètres de partage
Problèmes de Synchronisation
  • Vérifiez que le format du lien du dossier est correct
  • Vérifiez le paramètre Date de Début s’il est utilisé
  • Révisez les limitations de type de fichier et de taille
Pour un support supplémentaire avec la configuration de la source de données Google Drive, contactez l’équipe de développement.
⌘I