Vous pouvez utiliser des libellés pour taguer, organiser et classer les messages et les fils de discussion dans Gmail. Un libellé a une relation de plusieurs à plusieurs avec les messages et les fils de discussion: vous pouvez appliquer plusieurs libellés à un seul message ou fil de discussion, et un seul libellé à plusieurs messages ou fils de discussion.
Pour savoir comment create, 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 SYSTEM réservés et les libellés USER personnalisés.
Les libellés système correspondent généralement à des éléments prédéfinis dans 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é automatiquement aux messages envoyés avec drafts.send ou messages.send, insérés avec messages.insert et l'adresse e-mail de l'utilisateur dans l'en-tête From, ou envoyés 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 qui s'affichent dans l'onglet "Personnel" de l'interface Gmail. |
CATEGORY_SOCIAL |
oui | Correspond aux messages qui s'affichent dans l'onglet "Réseaux sociaux" de l'interface Gmail. |
CATEGORY_PROMOTIONS |
oui | Correspond aux messages qui s'affichent dans l'onglet "Promotions" de l'interface Gmail. |
CATEGORY_UPDATES |
oui | Correspond aux messages qui s'affichent dans l'onglet "Mises à jour" 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 ne s'appliquent qu'aux messages. Par exemple, si vous listez des libellés sur un fil de discussion, vous obtenez une liste des libellés qui existent sur l'un des messages du fil de discussion. Il est possible qu'un libellé n'existe pas pour tous les messages d'un fil de discussion. Vous pouvez appliquer plusieurs libellés aux messages, mais pas aux brouillons.
Ajouter ou supprimer des libellés à des fils de discussion
Lorsque vous ajoutez ou supprimez un libellé à un fil de discussion, vous ajoutez ou supprimez le libellé spécifié sur tous les messages existants du fil de discussion.
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 fil de discussion, utilisez threads.modify.
Ajouter ou supprimer des libellés à 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 un 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.