Tipo de recurso messageRule

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa una regla que se aplica a los mensajes de la Bandeja de entrada de un usuario.

En Outlook, puede establecer reglas de los mensajes entrantes en la Bandeja de entrada para llevar a cabo acciones específicas en determinadas condiciones.

Mediante programación, tiene acceso a las reglas a través de la propiedad de navegación messageRules de la carpeta Bandeja de entrada. Cada regla se representa mediante este recurso messageRule, las acciones de regla disponibles se representan mediante el tipo complejo messageRuleActions y las condiciones de regla disponibles se representan mediante el tipo complejo messageRulePredicates.

Métodos

Método	Tipo de valor devuelto	Descripción
Enumerar reglas	Colección messageRule	Obtener todos los objetos messageRule definidos para la Bandeja de entrada del usuario.
Obtener regla	messageRule	Leer las propiedades y relaciones de un objeto messageRule.
Crear regla	messageRule	Crear un objeto messageRule especificando un conjunto de condiciones y acciones.
Actualizar regla	messageRule	Cambie las propiedades modificables en un objeto messageRule y guarde los cambios.
Eliminar regla	Ninguno	Eliminar el objeto messageRule especificado.

Propiedades

Propiedad	Tipo	Descripción
actions	messageRuleActions	Acciones que se van a realizar en un mensaje cuando se cumplan las condiciones correspondientes.
conditions	messageRulePredicates	Condiciones que, cuando se cumplen, desencadenan las acciones correspondientes para esa regla.
displayName	String	Nombre para mostrar de la regla.
exceptions	messageRulePredicates	Condiciones de excepción de la regla.
hasError	Boolean	Indica si la regla es una condición de error. Solo lectura.
id	String	Identificador único de la regla. Solo lectura.
isEnabled	Boolean	Indica si la regla está habilitada para que se aplique a los mensajes.
isReadOnly	Boolean	Indica si la regla es de solo lectura y la API de REST de reglas no la puede modificar ni eliminar.
sequence	Int32	Indica el orden en que se ejecuta la regla entre otras reglas.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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