Partilhar via

Tipo de recurso messageRule

  • Artigo

Namespace: microsoft.graph

Representa uma regra que se aplica a mensagens na Caixa de Entrada de um utilizador.

No Outlook, é possível configurar regras para mensagens recebidas na Caixa de Entrada, para realizar ações específicas em determinadas condições.

Programaticamente, você pode acessar regras por meio da propriedade de navegação messageRules da pasta Caixa de Entrada. Cada regra é representada por esse recurso messageRule, as ações de regra disponíveis são representadas pelo tipo complexo messageRuleActions e as condições e exceções de regra disponíveis são representadas pelo tipo complexo messageRulePredicates.

Métodos

Método Tipo de retorno Descrição
Listar regras Coleção messageRule Obtenha todos os objetos messageRule definidos para a Caixa de Entrada do usuário.
Obter regra messageRule Leia as propriedades e as relações de um objeto messageRule.
Criar regra messageRule Crie um objeto messageRule especificando um conjunto de condições e ações.
Atualizar regra messageRule Altere as propriedades graváveis em um objeto messageRule e salve as alterações.
Excluir regra Nenhum Exclua o objeto messageRule especificado.

Propriedades

Propriedade Tipo Descrição
actions messageRuleActions Ações a serem realizadas em uma mensagem quando as condições correspondentes forem atendidas.
conditions messageRulePredicates Condições que, quando cumpridas, acionam as ações correspondentes para essa regra.
displayName Cadeia de caracteres O nome de exibição da regra.
exceptions messageRulePredicates Condições de exceção para a regra.
hasError Boolean Indica se a regra está em uma condição de erro. Somente leitura.
id Cadeia de caracteres O identificador exclusivo da regra. Somente leitura.
isEnabled Boolean Indica se a regra está habilitada para ser aplicada a mensagens.
isReadOnly Boolean Indica se a regra é somente leitura e não pode ser modificada ou excluída pelas regras da API REST.
sequence Int32 Indica a ordem em que a regra é executada, entre outras regras.

Representação JSON

A representação JSON seguinte mostra o 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"
}