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
| 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 categoría | outlookCategory | Crear un objeto outlookCategory en la lista principal de categorías del usuario. |
| Actualizar categoría | outlookCategory | Actualizar la propiedad modificable color del objeto outlookCategory especificado. |
| Eliminar categoría | 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,preset0ypreset1. 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 representación JSON muestra el tipo de recurso.
{
"color": "String",
"displayName": "String"
}