Tipo de recurso outlookCategory

Namespace: microsoft.graph

Representa uma categoria pela qual um usuário pode agrupar itens do Outlook como mensagens e eventos. O usuário define categorias em uma lista mestra e pode aplicar uma ou mais das seguintes categorias definidas pelo usuário a um item.

Usando a API REST, é possível criar e definir categorias na lista mestra de categorias para um usuário. Também é possível acessar essa lista mestra de categorias, obter uma categoria específica, atualizar a cor associada a uma categoria ou excluir uma categoria. É possível aplicar uma categoria a um item atribuindo a propriedade displayName da categoria à coleção categories do item. Os recursos que podem ser atribuídos a categorias incluem contacto, evento, mensagem, publicação e todoTask.

Cada categoria é atribuída por duas propriedades: displayName e color. O valor displayName deve ser exclusivo na lista mestra de um usuário. No entanto, o valor color não precisa ser exclusivo. Várias categorias na lista mestra podem ser mapeadas para a mesma cor. É possível mapear até 25 cores diferentes para as categorias na lista mestra a um usuário.

Métodos

Propriedades

Observação Os valores possíveis para color são constantes predefinidas como None, preset0 e preset1. Cada constante predefinida é mapeada para uma cor. A cor real depende do cliente do Outlook em que as categorias estão sendo exibidas. A tabela a seguir mostra as cores mapeadas para cada constante predefinida do Outlook (cliente da área de trabalho).

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "color": "String",
  "displayName": "String"
}