Vous pouvez utiliser des libellés pour taguer, organiser et classer les messages et les fils de discussion dans Gmail. Un libellé est associé à une relation de plusieurs à plusieurs avec les messages et les threads: vous pouvez appliquer plusieurs libellés à un même message ou fil de discussion, et appliquer un seul libellé à plusieurs messages ou threads.
Pour en savoir plus sur la manière de créer, obtenir, lister, mettre à jour ou supprimer des libellés, consultez la documentation de référence sur les étiquettes.
Pour gérer les étiquettes, vous devez utiliser le champ d'application https://www.googleapis.com/auth/gmail.labels. Pour en savoir plus sur les champs d'application, consultez la section Informations d'autorisation et d'authentification spécifiques à l'API Gmail.
Types d'étiquettes
Il existe deux types d'étiquettes: les étiquettes SYSTEM réservées et les étiquettes USER personnalisées.
Les libellés système correspondent généralement aux éléments prédéfinis dans l'interface Web de Gmail, tels que la boîte de réception. Les noms de libellés de 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 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 |
no | 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 |
no | 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 "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 des messages et des fils de discussion
Les libellés n'existent que sur les messages. Par exemple, si vous répertoriez les libellés d'un thread, vous obtenez la liste des libellés existants sur n'importe quel message du thread. Un libellé peut ne pas exister 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 dans les fils de discussion
Lorsque vous ajoutez ou supprimez un libellé dans un fil de discussion, vous ajoutez ou supprimez ce libellé pour tous les messages existants du fil de discussion.
Si des messages sont ajoutés à un fil de discussion après l'ajout d'un libellé, les nouveaux messages n'héritent pas du libellé existant associé au fil de discussion. Pour appliquer 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 des libellés aux messages ou en supprimer
Lorsque vous attribuez un libellé à un message, il est ajouté au message et associé au fil de discussion auquel le message 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 associé à 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.