Tipo de recurso openTypeExtension (extensiones abiertas)

Espacio de nombres: microsoft.graph

Las extensiones abiertas (anteriormente conocidas como extensiones de datos de Office 365) ofrecen una manera fácil de agregar propiedades sin tipo directamente a un recurso en Microsoft Graph.

El recurso openTypeExtension representa las extensiones abiertas. Las extensiones abiertas agregadas a un recurso se muestran en la propiedad de navegación extensions, que se deriva del tipo abstracto extension. 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 los dominios de Microsoft (com.microsoft o com.onmicrosoft) en un nombre de extensión.

Ejemplo de extensión abierta: Agregar datos personalizados a los usuarios mediante extensiones abiertas

Las extensiones abiertas son compatibles con los siguientes recursos en las versiones correspondientes: disponibilidad general ( /v1.0) o en versión preliminar (/beta).

Recurso Versión
Unidad administrativa GA
Evento de calendario * GA
Evento de calendario de grupo GA
Publicación de subproceso de conversación de grupo GA
device GA
group GA
message GA
organization GA
Contacto personal GA
user GA
Task GA
Task list GA

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

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.

Representación JSON

Aquí tiene una representación JSON del recurso.

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

Propiedades

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

Relaciones

Ninguno

Métodos

Método Tipo de valor devuelto Descripción
Crear openTypeExtension (en una instancia de recurso existente) o un nuevo contacto, eventos, mensaje, post, todoTasko 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.