Type de ressource messageRule
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente une règle qui s’applique aux messages dans la boîte de réception d’un utilisateur.
Dans Outlook, vous pouvez configurer des règles pour les messages entrants dans la boîte de réception afin d’exécuter des actions spécifiques selon certaines conditions.
Par programme, vous pouvez accéder aux règles via la propriété de navigation messageRules du dossier de boîte de réception. Chaque règle est représentée par cette ressource messageRule. Les actions de règle disponibles sont représentées par le type complexe messageRuleActions. Les exceptions et les conditions de règle disponibles sont représentées par le type complexe messageRulePredicates.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| List rules | Collection messageRule | Obtenez tous les objets messageRule définis pour la boîte de réception de l’utilisateur. |
| Get rule | messageRule | Lisez les propriétés et les relations d’un objet messageRule. |
| Créer une règle | messageRule | Créez un objet messageRule en spécifiant un ensemble de conditions et d’actions. |
| Mettre à jour une règle | messageRule | Modifiez les propriétés accessibles en écriture sur un objet messageRule et enregistrez les modifications. |
| Supprimer une règle | Aucune | Supprimez l’objet messageRule spécifié. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| actions | messageRuleActions | Actions à effectuer sur un message lorsque les conditions correspondantes sont remplies. |
| conditions | messageRulePredicates | Les conditions qui, lorsqu’elles sont remplies, déclenchent les actions correspondantes pour cette règle. |
| displayName | String | Nom d’affichage de la règle. |
| exceptions | messageRulePredicates | Conditions d’exception pour la règle. |
| hasError | Booléen | Indique si la règle se trouve dans une condition d’erreur. En lecture seule. |
| id | String | Identificateur unique de la règle. En lecture seule. |
| isEnabled | Booléen | Indique si la règle peut être appliquée aux messages. |
| isReadOnly | Booléen | Indique si la règle est accessible en lecture seule. Si oui, elle ne peut pas être modifiée ou supprimée par l’API REST de règles. |
| séquence | Int32 | Indique l’ordre dans lequel la règle est exécutée, parmi d’autres règles. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"actions": {"@odata.type": "microsoft.graph.messageRuleActions"},
"conditions": {"@odata.type": "microsoft.graph.messageRulePredicates"},
"displayName": "String",
"exceptions": {"@odata.type": "microsoft.graph.messageRulePredicates"},
"hasError": "Boolean",
"id": "String",
"isEnabled": "Boolean",
"isReadOnly": "Boolean",
"sequence": "Int32"
}