Google Drive

Le node Google Drive permet aux utilisateurs de sélectionner des fichiers depuis leur Google Drive à l'exécution et expose la sélection sous forme de tableau aux nodes en aval.

À quoi sert le node Google Drive ?

Le node d’entrée Google Drive crée un sélecteur de fichiers à l’exécution : la personne qui lance le workflow choisit elle-même les fichiers Google Drive à traiter. Contrairement au Google Drive Reader (qui pré-sélectionne les fichiers à la conception), ce node diffère la sélection jusqu’à l’exécution et renvoie les fichiers choisis sous forme de tableau dont le type suit le filtre fileType.

Cas d’usage typiques :

• Construire des workflows en libre-service où les utilisateurs finaux choisissent leur propre contenu Drive à l’exécution.
• Permettre aux utilisateurs de fournir des vidéos, images ou documents à des nodes IA (Video to Text, Image to Text, Data Analyzer) sans modifier le workflow.
• Partager un même workflow au sein d’une équipe où chaque membre traite ses propres fichiers.
• Alimenter des boucles de traitement par lot en activant la multi-sélection puis en branchant le tableau sur un node Loop.

Configuration rapide

Suivez ces étapes pour ajouter et configurer le node Google Drive dans votre workflow :

Paramètres de configuration

La configuration du node consiste à choisir une intégration et à aligner le filtre de type de fichier avec ce que les nodes en aval attendent.

Champs requis

Champs optionnels

Que renvoie le node ?

Le node renvoie un tableau de fichiers sélectionnés. Le type des éléments suit le paramètre fileType : video et image produisent des références typées ; les autres valeurs produisent des références de fichier génériques.

Comment récupérer l’output ?

Dans Draft & Goal, vous n’avez pas besoin de chercher un nom de variable généré par le système. Pour exploiter le résultat :

1. Tirez un lien depuis le port de sortie du node Google Drive.
2. Connectez-le à l’entrée du node suivant.
3. Dans ce node suivant, créez et nommez votre propre variable (par exemple, fichiers_utilisateur). Les fichiers sélectionnés y seront injectés automatiquement.

[
  {
    "id": "1aBcDeFgHiJkLmNoPqRs",
    "name": "product-demo.mp4",
    "mimeType": "video/mp4",
    "url": "https://drive.google.com/..."
  }
]

Exemples d’utilisation

Cas 1 : Vidéo sélectionnée par l’utilisateur pour une description IA

Permettre aux utilisateurs de choisir leur propre vidéo afin de générer une description à la demande.

Configuration :

• fileType = video
• multiLines = false
• required = true

Workflow :

1. Google Drive — L’utilisateur sélectionne une vidéo à l’exécution.
2. Video to Text — L’IA génère une description de la vidéo sélectionnée.
3. LLM — Affine la description pour un canal ou un public donné.

Cas 2 : Traitement par lot d’images depuis Drive

Permettre à l’utilisateur de sélectionner plusieurs images et de les analyser en boucle.

Configuration :

• fileType = image
• multiLines = true
• required = true

Workflow :

1. Google Drive — L’utilisateur choisit plusieurs images.
2. Loop — Itère sur le tableau.
3. Image to Text — Analyse chaque image dans la boucle.
4. Join List — Combine toutes les descriptions en une seule sortie.

Problèmes courants

Le sélecteur de fichiers n'affiche aucun fichier

Cause : L’intégration Google Drive a perdu son autorisation, ou aucun fichier du compte connecté ne correspond au fileType choisi.

Solution : Ouvrez Settings > Integrations et vérifiez que la connexion Google Drive est active ; reconnectez-la si nécessaire. Si fileType est défini, vérifiez que des fichiers correspondants existent dans le compte parcouru.

Les nodes en aval échouent avec une erreur de type

Cause : Le node en aval attend un type de média précis (par ex. vidéo) mais le sélecteur est sur all et l’utilisateur a choisi un autre type de fichier.

Solution : Réglez fileType pour correspondre à l’entrée attendue — video pour Video to Text, image pour Image to Text — afin que la sortie typée bloque les sélections incompatibles dès la conception.

Le workflow s'exécute sans aucun fichier sélectionné

Cause : required vaut false, donc l’exécution accepte un tableau vide.

Solution : Activez required si au moins un fichier doit être choisi. Si le champ doit rester optionnel, protégez les nodes en aval avec un node Conditional qui vérifie la longueur du tableau.

Bonnes pratiques et pièges à éviter

Comment s’intègre-t-il dans un workflow ?

Le node Google Drive est le point d’entrée d’un workflow piloté par l’exécution : l’utilisateur fournit la donnée source, le reste du graphe la traite.

graph LR
    Drive[Google Drive
<br/>sélecteur runtime] --> Loop[Loop]
    Loop --> AI[Image/Video to Text]
    AI --> LLM[LLM affine la sortie]
    LLM --> Out[Résultat final]

Nodes complémentaires