Tipo de recurso outlookCategory
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Precaución
Las tareas de Outlook están en desuso y dejaron de devolver datos el 10 de agosto de 2022. Actualice las aplicaciones existentes que usan esta característica con tareas de Outlook.
Representa una categoría en la que un usuario puede agrupar elementos de Outlook tales como mensajes y eventos. En Outlook, el usuario define categorías en una lista maestra 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 contact, event, message, outlookTask, post y todoTask.
A cada categoría se le atribuyen dos propiedades: displayName y color. El valor de displayName debe ser único en la lista principal de un usuario. Sin embargo, el color no tiene que ser único; varias categorías de la lista maestra se pueden asignar al mismo color. 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 |
|---|---|---|
| List | Colección outlookCategory | Obtener todas las categorías que han sido definidas por el usuario. |
| Get | 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 | String | Constante de color preestablecida que caracteriza una categoría y que está asignada a 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. Una vez creada una categoría, no se puede cambiar el nombre. Solo lectura. |
Nota Los valores posibles para el color son constantes preestablecidas como
None,preset0ypreset1. Cada constante preestablecida se asigna aún más a un color; el color real depende del cliente de Outlook en el que se muestran las categorías. En la tabla siguiente se muestran los colores asignados a cada constante preestablecida para 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"
}