Type de ressource outlookCategory
Espace de noms: microsoft.graph
Représente une catégorie sous laquelle un utilisateur peut regrouper des éléments Outlook tels que des messages et des événements. L’utilisateur définit des catégories dans une liste principale et peut appliquer ces catégories définies par l’utilisateur à un élément.
Avec l’API REST, vous pouvez créer et définir des catégories dans la liste principale des catégories pour un utilisateur. Vous pouvez également obtenir cette liste principale des catégories, obtenir une catégorie spécifique, mettre à jour la couleur associée à une catégorie ou supprimerune catégorie. Vous pouvez appliquer une catégorie à un élément en affectant la propriété displayName de la catégorie à la collection categories de l’élément. Les ressources qui peuvent être affectées à des catégories incluent le contact, l’événement, le message, la publication et todoTask.
Deux propriétés sont affectées à chaque catégorie : displayName et color. La valeur displayName doit être unique dans la liste principale d’un utilisateur. En revanche, la propriété color ne doit pas obligatoirement être unique. Plusieurs catégories de la liste principale peuvent être mappées à la même couleur. Vous pouvez mapper jusqu’à 25 couleurs différentes aux catégories dans la liste principale d’un utilisateur.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| List categories | Collection outlookCategory | Obtenez toutes les catégories qui ont été définies pour l’utilisateur. |
| Get category | outlookCategory | Obtenez les propriétés et les relations de l’objet outlookCategory spécifié. |
| Create category | outlookCategory | Créez un objet outlookCategory dans la liste principale des catégories de l’utilisateur. |
| Mettre à jour une catégorie | outlookCategory | Mettez à jour la propriété accessible en écriture, color, de l’objet outlookCategory spécifié. |
| Supprimer une catégorie | Aucune | Supprimez l’objet outlookCategory spécifié. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| color | categoryColor | Constante de couleur prédéfinie qui caractérise une catégorie et qui est mappée avec l’une des 25 couleurs prédéfinies. Pour plus d’informations, consultez la note suivante. |
| displayName | String | Nom unique qui identifie une catégorie dans la boîte aux lettres de l’utilisateur. Après la création d’une catégorie, le nom ne peut pas être modifié. En lecture seule. |
Remarque : les valeurs possibles pour color sont des constantes prédéfinies comme
None,preset0etpreset1. Chaque constante prédéfinie est mappée à une couleur. La couleur réelle varie selon le client Outlook où les catégories sont affichées. Le tableau suivant indique les couleurs mappées à chaque constante prédéfinie pour Outlook (client de bureau).
| Constante prédéfinie | Couleur mappée dans Outlook |
|---|---|
| Aucun | Aucune couleur mappée |
| Preset0 | Rouge |
| Preset1 | Orange |
| Preset2 | Marron |
| Preset3 | Jaune |
| Preset4 | Vert |
| Preset5 | Bleu-vert |
| Preset6 | Olive |
| Preset7 | Bleu |
| Preset8 | Violet |
| Preset9 | Couleur canneberge |
| Preset10 | Gris acier |
| Preset11 | Acier foncé |
| Preset12 | Gris |
| Preset13 | Gris foncé |
| Preset14 | Noir |
| Preset15 | Rouge foncé |
| Preset16 | Orange foncé |
| Preset17 | Marron foncé |
| Preset18 | Jaune foncé |
| Preset19 | Vert foncé |
| Preset20 | Bleu-vert foncé |
| Preset21 | Olive foncé |
| Preset22 | Bleu foncé |
| Preset23 | Violet foncé |
| Preset24 | Couleur canneberge foncé |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"color": "String",
"displayName": "String"
}