Información general sobre las propiedades extendidas de Outlook

  • Artículo

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.

Las propiedades extendidas permiten almacenar datos personalizados y sirven específicamente como mecanismo de reserva para que las aplicaciones accedan a datos personalizados para las propiedades MAPI de Outlook cuando estas propiedades aún no están expuestas en microsoft Graph API metadata_. Puede utilizar la API de REST de propiedades extendidas para almacenar u obtener dichos datos personalizados en los siguientes recursos de usuario:

O bien, en los siguientes recursos del grupo de Microsoft 365:

¿Usa propiedades extendidas o extensiones abiertas?

En los escenarios más comunes, debe poder usar extensiones abiertas (representadas por openTypeExtension, anteriormente conocidas como extensiones de datos Office 365) para almacenar y acceder a datos personalizados para instancias de recursos en el buzón de un usuario. Use propiedades extendidas solo si necesita acceder a datos personalizados para las propiedades MAPI de Outlook que aún no están expuestas en los metadatos de Microsoft Graph API.

Tipos de propiedades extendidas

Dependiendo de si desea almacenar un valor único o varios valores (del mismo tipo) en una propiedad extendida, puede crear una propiedad extendida como singleValueLegacyExtendedProperty o multiValueLegacyExtendedProperty.

Cada uno de estos tipos identifica la propiedad por su id (identificador) y almacena datos en value.

Puede utilizar id para obtener una instancia de un recurso específico junto con esa propiedad extendida o filtrar una propiedad extendida de valor único para obtener todas las instancias que tienen esa propiedad.

Nota No puede usar la API REST para obtener todas las propiedades extendidas de una instancia específica en una llamada.

Formatos de identificadores

Puede especificar id de una propiedad extendida en uno de tres formatos:

  • Como una propiedad con nombre, identificada por el tipo de propiedad extendida, espacio de nombres y un nombre de cadena.
  • Como una propiedad con nombre, identificada por el tipo de propiedad extendida, espacio de nombres y un identificador numérico.
  • En un formato proptag, identificado por el tipo de propiedad extendida y una etiqueta de propiedad MAPI.

En las dos tablas siguientes se describen estos formatos como aplicados a las propiedades extendidas de valor único y multivalor. {type} representa el tipo de valor o valores de la propiedad extendida. Lo que se muestra en los ejemplos son la cadena, el número entero y las matrices de estos tipos.

Formatos de identificador válidos para propiedades extendidas de valor único

Formato Ejemplo Descripción
“{type} {guid} Nombre {name}” "String {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Name TestProperty" Identifica una propiedad mediante el espacio de nombres (GUID) al que pertenece y mediante un nombre de cadena.
“{type} {guid} Id. {id}” "Integer {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Id 0x8012" Identifica una propiedad mediante el espacio de nombres (GUID) al que pertenece y mediante un identificador numérico.
"{type} {proptag}" "String 0x4001" Identifica una propiedad predefinida por su etiqueta de propiedad.

Formatos de identificador válidos para propiedades extendidas de varios valores

Formato Ejemplo Descripción
“{type} {guid} Nombre {name}” "StringArray {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Name TestProperty" Identifica una propiedad mediante el espacio de nombres (GUID) y un nombre de cadena.
“{type} {guid} Id. {id}” "IntegerArray {8ECCC264-6880-4EBE-992F-8888D2EEAA1D} Id 0x8013" Identifica una propiedad mediante el espacio de nombres (GUID) y un identificador numérico.
"{type} {proptag}" "StringArray 0x4002" Identifica una propiedad predefinida por su etiqueta de propiedad.

Use uno de los formatos de propiedad con nombre para definir una propiedad extendida de valor único o multivalor como personalizada. Entre los dos formatos, el primero que toma un nombre de cadena (Nombre) es el formato preferido para facilitar la referencia. Las propiedades con nombre tienen sus identificadores de propiedad en el rango 0x8000-0xfffe.

Use el formato proptag para acceder a las propiedades predefinidas por MAPI, o por un cliente o servidor, y que aún no se han expuesto en Microsoft Graph. Estas propiedades tienen identificadores de propiedad en el rango 0x0001-0x7fff. No intente definir una propiedad personalizada con el formato proptag.

Puede encontrar información sobre la asignación de una propiedad extendida a una propiedad MAPI existente, como el identificador de propiedad y el GUID, en [MS-OXPROPS] Microsoft Corporation, "Exchange Server Protocols Master Property List".

Nota: Después de elegir un formato para el id., deberá obtener acceso a la propiedad extendida únicamente con ese formato.

Operaciones de la API de REST

Operaciones de propiedades extendidas de valor único:

Operaciones de propiedades extendidas de varios valores: