Información general sobre las propiedades extendidas de Outlook

Espacio de nombres: microsoft.graph

Las propiedades extendidas permiten almacenar datos personalizados y sirven específicamente como un mecanismo de reserva para que las aplicaciones accedan a datos personalizados de propiedades MAPI de Outlook si estas propiedades aún no están expuestas en los metadatos de la API de Microsoft Graph. 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 casos más comunes, debería poder utilizar las extensiones abiertas (representadas por openTypeExtension, anteriormente conocidas como extensiones de datos de Office 365) para almacenar y acceder a datos personalizados de instancias de recurso en el buzón de un usuario. Utilice las propiedades extendidas solo si necesita acceder a datos personalizados de las propiedades MAPI de Outlook que aún no están expuestos en los metadatos de la API de Microsoft Graph.

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 utilizar la API de 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 los formatos como se aplican para 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 0x4001001E" Identifica una propiedad predefinida mediante 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 0x4002101E" Identifica una propiedad predefinida mediante 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 obtener acceso a propiedades predefinidas por MAPI o por un cliente o servidor y que no se han expuesto aún en Microsoft Graph. Estas propiedades tienen identificadores de propiedad en el rango 0x0001-0x7fff. No intente definir una propiedad personalizada con el formato proptag.

Encontrará información sobre la asignación de una propiedad extendida a una propiedad MAPI existente (como el identificador de la propiedad y el GUID) en [MS-OXPROPS] Microsoft Corporation, “Exchange Server Protocols Master Property List” (Lista de propiedades Master de los protocolos de Exchange Server).

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: