Tipo de recurso outlookCategory

  • Artículo

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

Método Tipo de valor devuelto Descripción
Enumerar categorías Colección outlookCategory Obtener todas las categorías que han sido definidas por el usuario.
Obtener categoría outlookCategory Obtener las propiedades y relaciones del objeto outlookCategory especificado.
Crear outlookCategory Crear un objeto outlookCategory en la lista principal de categorías del usuario.
Actualizar outlookCategory Actualizar la propiedad modificable color del objeto outlookCategory especificado.
Eliminar Ninguno Eliminar el objeto outlookCategory especificado.

Propiedades

Propiedad Tipo Descripción
color categoryColor Constante de color preestablecida que caracteriza a una categoría y a la que se asigna uno de los 25 colores predefinidos. Para obtener más información, consulte la nota siguiente.
displayName String Nombre único que identifica una categoría en el buzón del usuario. Después de crear una categoría, no puede cambiarse el nombre. Solo lectura.

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).

Constante preestablecida Color al que se asigna en Outlook
Ninguno Ningún color asignado
Preset0 Rojo
Preset1 Naranja
Preset2 Marrón
Preset3 Amarillo
Preset4 Verde
Preset5 Verde azulado
Preset6 Oliva
Preset7 Azul
Preset8 Púrpura
Preset9 Arándano
Preset10 Acero
Preset11 Acero oscuro
Preset12 Gris
Preset13 Gris oscuro
Preset14 Negro
Preset15 Rojo oscuro
Preset16 Anaranjado oscuro
Preset17 Marrón oscuro
Preset18 Amarillo oscuro
Preset19 Verde oscuro
Preset20 Verde azulado oscuro
Preset21 Oliva oscuro
Preset22 Azul oscuro
Preset23 Púrpura oscuro
Preset24 Arándano oscuro

Representación JSON

La siguiente es una representación JSON del recurso

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