Vous pouvez utiliser des libellés pour marquer, 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, mettre à jour ou supprimer des libellés, consultez la documentation de référence sur les libellés.
Pour gérer les libellés, vous devez utiliser le champ d'application https://www.googleapis.com/auth/gmail.labels. Pour en savoir plus sur les habilitations, consultez Informations sur l'autorisation et l'authentification spécifiques à 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 la boîte de réception. Les noms de libellés système sont réservés. Vous ne pouvez pas créer de libellé USER portant le même nom qu'un libellé SYSTEM. Le tableau suivant répertorie plusieurs 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 | Appliquée automatiquement aux messages envoyés avec
drafts.send ou
messages.send, insérée
avec messages.insert
et l'adresse e-mail de l'utilisateur dans l'en-tête From, ou envoyée par l'utilisateur via
l'interface Web. |
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 messages et les fils de discussion
Les libellés n'existent que sur les messages. Par exemple, si vous listez les libellés d'un fil de discussion, vous obtenez la liste des libellés qui existent sur l'un des messages du fil. Il est possible qu'un libellé n'existe pas pour chaque message d'un fil de discussion. Vous pouvez appliquer plusieurs libellés à des messages, mais pas à des brouillons.
Ajouter ou supprimer des libellés dans des fils de discussion
Lorsque vous ajoutez ou supprimez un libellé dans un fil de discussion, vous ajoutez ou supprimez le libellé spécifié sur 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 dans 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.