# Gmail - Nœud de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/gmail

Language: fr

Rechercher, lire et envoyer des messages Gmail, gérer les libellés et la corbeille.

## Utilisation et spécificités

Sélectionnez un identifiant Gmail OAuth autorisé pour l’opération. Utilisez query et la pagination pour lister les messages ; renseignez destinataires et contenu pour envoyer. Vérifiez les labels et les droits avant modification.

Type technique : `gmail`. Runtime : `nodulz`.

## Identifiants et prérequis

- [Gmail](/docs/credentials) (`integration` / `gmail`). OAuth Google avec accès à votre boîte Gmail et renouvellement automatique du jeton.

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le [guide des identifiants](/docs/credentials) pour les accès et la rotation.

## Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `credentialId` | `string` | `""` | - |
| `operation` | `enum` | `"list_messages"` | `list_messages`, `get_message`, `send_message`, `modify_labels`, `trash_message`, `untrash_message`, `list_labels` |
| `messageId` | `string` | `""` | - |
| `query` | `string` | `""` | - |
| `pageSize` | `number` | `100` | -; ≥ 1, ≤ 500 |
| `pageToken` | `string` | `""` | - |
| `to` | `string` | `""` | - |
| `cc` | `string` | `""` | - |
| `bcc` | `string` | `""` | - |
| `subject` | `string` | `""` | - |
| `body` | `string` | `""` | - |
| `bodyType` | `enum` | `"text"` | `text`, `html` |
| `addLabelIds` | `string` | `""` | - |
| `removeLabelIds` | `string` | `""` | - |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `credentialId`<br>Identifiant Gmail | Utilisez un identifiant Gmail OAuth. Aucun mot de passe ni compte de service. Les permissions doivent autoriser l’action choisie. |
| `operation`<br>Action | La corbeille est réversible. Pour archiver ou marquer comme lu, retirez respectivement INBOX ou UNREAD. |
| `bodyType`<br>Format du message | Texte brut ou HTML. L’encodage MIME et Base64 URL est automatique. |
| `body`<br>Contenu | Contenu du message ou expression. Maximum 5 Mio pour le message MIME encodé. |

## Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

```json
{
  "credentialId": "",
  "operation": "list_messages",
  "query": "",
  "pageSize": 100,
  "pageToken": "",
  "messageId": "",
  "to": "",
  "cc": "",
  "bcc": "",
  "subject": "",
  "body": "",
  "bodyType": "text",
  "addLabelIds": "",
  "removeLabelIds": ""
}
```

## Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : [Expressions et données](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)