Partager via


Type de ressource messageRule

Espace de noms: microsoft.graph

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"
}