Tipo de recurso openTypeExtension (extensiones abiertas)

Espacio de nombres: microsoft.graph

Representa las extensiones abiertas (anteriormente conocidas como extensiones de datos de Office 365), una opción de extensibilidad que proporciona una manera sencilla de agregar directamente propiedades sin tipo a un recurso en Microsoft Graph.

Cualquier extensión abierta agregada a un recurso se muestra en la propiedad de navegación extensiones. Cada extensión tiene una propiedad extensionName que es la única predefinida y que puede ser escrita para todas las extensiones, junto con los datos personalizados. Una forma de asegurarse de que los nombres de extensión son únicos es usar un método inverso del formato de nombres de dominio (DNS) que dependa de su propio dominio, por ejemplo, com.contoso.ContactInfo. No use el dominio de Microsoft (com.microsoft o com.onmicrosoft) en un nombre de extensión.

Deriva del tipo abstracto de extensión.

Los siguientes recursos admiten las extensiones abiertas.

Nota: * Debido a una limitación de servicio existente, los delegados no pueden crear eventos abiertos anexados a una extensión en calendarios de buzones compartidos. Los intentos de hacerlo producirán una ErrorAccessDenied respuesta.

Para obtener más información sobre la extensibilidad de Microsoft Graph, incluidos los límites de las extensiones abiertas, consulte Agregar propiedades personalizadas a los recursos mediante extensiones y Agregar datos personalizados a los usuarios mediante extensiones abiertas.

Consideraciones específicas de Outlook

Cada extensión abierta presente en un recurso de Outlook (evento, mensaje o contacto personal) se almacena en una propiedad con nombre MAPI. Cuando crea extensiones abiertas para Outlook, tenga en cuenta que las propiedades con nombre MAPI son un recurso limitado en un buzón de usuario. Cuando se agota la cuota de propiedad con nombre de un usuario, no puede crear más propiedades con nombre para ese usuario. Esto puede provocar un comportamiento inesperado de los clientes que dependan de propiedades con nombre para funcionar.

Siga las siguientes instrucciones al crear extensiones abiertas en recursos de Outlook:

  • Cree el número mínimo de extensiones necesarias. La mayoría de las aplicaciones no deberían requerir más de una extensión. Las extensiones no tienen un conjunto de propiedades o estructuras definido para que pueda almacenar varios valores en una única extensión.
  • Evite nombrar las extensiones de manera variable (por ejemplo basándose en las entradas del usuario, etcétera). Cada vez que se crea una extensión abierta con un nuevo nombre que no se haya usado en un buzón de usuario antes, se crea una nueva propiedad con nombre MAPI. Quitar la extensión no elimina la propiedad con nombre.

Usar extensiones abiertas (para recursos de Outlook) o propiedades extendidas

Las extensiones de datos son la solución recomendada en la mayoría de escenarios relacionados con el almacenamiento y el acceso de datos personalizados. Sin embargo, si necesita acceder a datos personalizados para las propiedades MAPI de Outlook que no están ya expuestas en los metadatos API de Microsoft Graph, puede usar propiedades extendidas y su API REST. Puede comprobar las propiedades que exponen los metadatos en https://graph.microsoft.com/v1.0/$metadata.

Métodos

Método Tipo de valor devuelto Descripción
Crear openTypeExtension(en una instancia de recurso existente) o un nuevo todoTask, todotasklistcontacto, evento, mensaje, publicación, todoTask o todoTaskList que contiene un objeto openTypeExtension. Cree un objeto openTypeExtension en una instancia de recursos nueva o existente.
Get openTypeExtension Lea las propiedades y las relaciones del objeto openTypeExtension.
Actualizar openTypeExtension Actualice el objeto openTypeExtension.
Eliminar Ninguno Elimine el objeto openTypeExtension.

Propiedades

Propiedad Tipo Descripción
extensionName String Un identificador de texto único para una extensión de datos de tipo abierto. Necesario.
id String Un identificador completo que concatena el tipo de extensión con el extensionName. Solo lectura.

Relaciones

Ninguno

Representación JSON

Aquí tiene una representación JSON del recurso.

{
  "extensionName": "string",
  "id": "string (identifier)"
}

Consulte también