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 aplicaciones existentes que usan esta característica con tareas de Outlook deben actualizarse, ya que las tareas de Outlook están en desuso. Consulte Api de tareas pendientes en versión preliminar pública para obtener más información.
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 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 | String | 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
ypreset1
. 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"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de