Ce document explique comment gérer les libellés sur les fils de discussion et les messages à l'aide de l'API Gmail.
Vous pouvez utiliser des libellés pour taguer, organiser et classer les messages et les fils de discussion dans Gmail. Un libellé entretient une relation de type plusieurs à plusieurs avec les messages et les fils de discussion : vous pouvez appliquer plusieurs libellés à un même message ou fil de discussion, et appliquer un même libellé à plusieurs messages ou fils de discussion.
Pour savoir comment créer, obtenir, lister, modifier ou supprimer des libellés, consultez la ressource labels.
Pour gérer les libellés, vous devez utiliser le champ d'application non sensible https://www.googleapis.com/auth/gmail.labels. Pour en savoir plus sur les habilitations, consultez Choisir les habilitations de l'API Gmail.
Types de libellés
Il existe deux types de libellés : les libellés réservés SYSTEM et les libellés personnalisés USER.
Les libellés système correspondent généralement à des éléments prédéfinis de l'interface Web Gmail, comme INBOX. Les noms des libellés système sont réservés. Aucun libellé USER ne peut être créé avec le même nom qu'un libellé SYSTEM. Le tableau suivant liste certains des libellés système Gmail les plus courants :
| Nom | Peut être appliqué manuellement | Remarques |
|---|---|---|
INBOX |
oui | |
SPAM |
oui | |
TRASH |
oui | |
UNREAD |
oui | |
STARRED |
oui | |
IMPORTANT |
oui | |
SENT |
non | Ils sont appliqués automatiquement aux messages qui :
|
DRAFT |
non | Appliqué automatiquement à tous les messages draft créés avec l'API Gmail ou l'interface Gmail. |
CATEGORY_PERSONAL |
oui | Correspond aux messages affichés dans l'onglet "Personnel" de l'interface Gmail. |
CATEGORY_SOCIAL |
oui | Correspond aux messages affichés dans l'onglet "Réseaux sociaux" de l'interface Gmail. |
CATEGORY_PROMOTIONS |
oui | Correspond aux messages affichés dans l'onglet "Promotions" de l'interface Gmail. |
CATEGORY_UPDATES |
oui | Correspond aux messages affichés dans l'onglet "Notifications" de l'interface Gmail. |
CATEGORY_FORUMS |
oui | Correspond aux messages affichés dans l'onglet "Forums" de l'interface Gmail. |
Gérer les libellés sur les fils de discussion et les messages
Les libellés n'existent que sur les messages. Si vous récupérez une liste de libellés sur un fil de discussion, vous obtenez une liste des libellés qui existent sur n'importe quel message du fil. Il est possible qu'un libellé n'existe pas sur tous les messages d'un fil de discussion.
Vous ne pouvez pas appliquer de libellés aux brouillons de messages.
Ajouter ou supprimer des libellés sur des fils de discussion
Lorsque vous ajoutez ou supprimez un libellé dans un fil de discussion, vous ajoutez ou supprimez le libellé spécifié dans tous les messages existants du fil.
Si des messages sont ajoutés à un fil de discussion après que vous avez ajouté un libellé, les nouveaux messages n'héritent pas du libellé existant associé au fil de discussion. Pour ajouter le libellé à ces messages, ajoutez-le à nouveau au fil de discussion.
Pour ajouter ou supprimer les libellés associés à un thread, utilisez threads.modify.
Ajouter ou supprimer des libellés sur des messages
Lorsque vous ajoutez un libellé à un message, il est ajouté à ce message et devient associé au fil de discussion auquel il appartient. Le libellé n'est pas ajouté aux autres messages du fil de discussion.
Si vous supprimez le libellé d'un message et qu'il s'agissait du seul message du fil de discussion portant ce libellé, le libellé est également supprimé du fil de discussion.
Pour ajouter ou supprimer les libellés appliqués à un message, utilisez messages.modify.