Tipo de recurso outlookCategory

Espacio de nombres: microsoft.graph

Representa una categoría en la que un usuario puede agrupar elementos de Outlook tales como mensajes y eventos. El usuario define categorías en una lista principal y puede aplicar una o varias de estas categorías definidas por el usuario a un elemento.

Con la API de REST, puede crear y definir categorías en la lista principal de categorías de un usuario. También puede obtener esta lista principal de categorías, obtener una categoría específica, actualizar el color asociado a una categoría o eliminar una categoría. Puede aplicar una categoría a un elemento asignando la propiedad displayName de la categoría a la colección categories del elemento. Los recursos a los que se pueden asignar categorías incluyen contacto, evento, mensaje, publicación y todoTask.

A cada categoría se le asignan atributos con dos propiedades: displayName y color. El valor de displayName debe ser único en la lista principal de un usuario. Pero el valor de color no tiene que ser único; puede asignarse el mismo color a varias categorías de la lista principal. Puede asignar hasta 25 colores distintos a las categorías de la lista principal de un usuario.

Métodos

Propiedades

Nota Los posibles valores de color son constantes preestablecidas tales como None, preset0 y preset1. A cada constante preestablecida se le asigna asimismo un color; el color real depende del cliente de Outlook en que se muestran las categorías. La siguiente tabla muestra los colores asignados a cada constante preestablecida en Outlook (cliente de escritorio).

Representación JSON

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

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