Mankomail

Drive — créer un dossier ​

Crée un dossier Google Drive s’il n’existe pas déjà sous le même parent, et rend son identifiant pour la suite du workflow.

Ce nœud garantit qu’un dossier Google Drive existe et rend son identifiant : il crée le dossier, sauf si un dossier du même nom existe déjà sous le même parent, auquel cas il le réutilise. C’est le moyen normal de donner une destination à Drive — déposer un fichier, par exemple un dossier par client ou par mois.

Il exige l’accès Google Drive d’un compte Google, affiché comme la capacité Fichiers dans Connexions. Voir Google. Le dossier est créé dans le Drive du membre qui exécute le workflow.

L’accès demandé est drive.file, qui ne laisse voir à l’application que ce qu’elle a créé. Un dossier créé par ce nœud est donc toujours visible des autres nœuds Drive, contrairement à un dossier créé à la main dans le navigateur.

En bref ​

  • Type : google_drive.create_folder · version 1
  • Catégorie : Actions
  • Nature : Étape — s’exécute pendant une exécution
  • Effet : Écrit à l’extérieur (external_write) — écrit hors de Mankomail ; décrit au lieu d’être fait pendant un essai
  • Exige un mail porteur : Non
  • Connexion : Google (capacité drive)
  • Entrées : main
  • Sorties : main

Connexion ​

Ce nœud exige une connexion Google avec la capacité drive accordée.

Paramètres ​

credential ​

Compte Google — Le compte qui porte l’accès Google Drive. Il se connecte une fois dans Connexions ; le workflow s’exécute toujours avec le compte du membre qui le fait tourner.

  • Type : Connexion (credential)
  • Requis : Oui
  • Défaut : "" (vide)

name ​

Nom du dossier — Accepte des expressions {{ }} : {{ email.from.name }} pour un dossier par client. Un dossier du même nom sous le même parent est réutilisé, jamais dupliqué.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 200 caractères au plus
  • Exemple : Factures 2026
  • Expressions : {{ }} accepté

parent ​

Dans le dossier — Laissé vide, le dossier est créé à la racine du Drive.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant, coller une URL (drive.folder)
  • Listé avec la connexion de : credential

Sorties ​

  • main

Données produites ​

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

  • {{ data.<step>.folder }} — object { id, name, mime, webViewLink?, folderId? }. Le dossier créé, ou celui qui existait déjà sous le même nom. mime vaut application/vnd.google-apps.folder, webViewLink est le lien qui l’ouvre dans Google Drive, folderId l’identifiant de son parent.
  • {{ data.<step>.folder.id }} — string. L’identifiant du dossier, à brancher dans le champ dossier d’une étape Drive suivante (mode identifiant).
  • {{ data.<step>.created }} — boolean. true quand le dossier a été créé par cette étape, false quand un dossier du même nom existait déjà sous le même parent et a été réutilisé.
  • {{ data.<step>.simulated }} — boolean. true en essai : rien n’a été créé et l’identifiant commence par simulated-.
  • {{ data.<step>.summary }} — string. Une phrase lisible qui dit si le dossier a été créé ou retrouvé.

Exemple ​

Chaque client a son dossier, sous un dossier Clients créé une fois par l’application. Le nœud s’appelle Dossier client :

name: {{ email.from.name }}
parent: (mode liste) Clients

Le premier mail de Jeanne Martin crée le dossier ; les données de l’étape sont :

json
{
  "folder": {
    "id": "1TxK9…",
    "name": "Jeanne Martin",
    "mime": "application/vnd.google-apps.folder",
    "webViewLink": "https://drive.google.com/drive/folders/1TxK9…",
    "folderId": "1AbC2…"
  },
  "created": true,
  "simulated": false
}

Les mails suivants du même expéditeur retrouvent le dossier, avec created: false. L’étape de dépôt qui suit prend {{ data.dossier_client.folder.id }} comme dossier de destination.

Conseils ​

  • Un dossier par nom. La correspondance porte sur le nom exact sous le même parent, parmi les dossiers qui ne sont pas à la corbeille. Deux exécutions qui demandent le même dossier aboutissent au même dossier ; une nouvelle tentative de l’étape n’en crée jamais un second.
  • Parent. Laissé vide, le dossier est créé à la racine du Drive. Le parent se choisit dans la liste (dossiers créés par l’application uniquement), se saisit par identifiant ou se colle sous forme d’URL de dossier Drive.
  • Nom vide. Un nom qui se résout à vide (une expression sans valeur) échoue avec node_invalid_param.
  • Essais. En essai, rien n’est créé : l’étape rend un dossier dont l’identifiant commence par simulated-, avec created: true et simulated: true. Une étape de dépôt qui utilise cet identifiant dans le même essai ne fait, elle aussi, que décrire son dépôt.
  • Erreurs. credential.capability_missing : Google Drive n’est pas connecté pour le membre qui exécute le workflow. google.not_found : le dossier parent n’existe pas ou l’application ne peut pas le voir. google.bad_locator : le parent collé n’est ni un identifiant ni une URL Drive reconnue. google.unavailable est retenté automatiquement. Voir Gestion des erreurs.