Tipo de recurso outlookCategory

Namespace: microsoft.graph

Representa uma categoria pela qual um usuário pode agrupar itens do Outlook como mensagens e eventos. No Outlook, o utilizador define categorias numa lista de master e pode aplicar uma ou mais destas categorias definidas pelo utilizador 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, outlookTask, post 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, a cor não tem de ser exclusiva; várias categorias na lista de master 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

Nota Os valores possíveis para a cor são constantes predefinidas, como None, preset0 e preset1. Cada constante predefinida é mapeada para uma cor; a cor real depende do cliente do Outlook no qual as categorias estão a ser apresentadas. A tabela seguinte mostra as cores mapeadas para cada constante predefinida para o Outlook (cliente de ambiente de trabalho).

Relações

Nenhum

Representação JSON

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

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