Tipo de recurso openTypeExtension (extensiones abiertas)openTypeExtension resource type (open extensions)

Importante

Las API de /beta la versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported.

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.Open extensions (formerly known as Office 365 data extensions) provide an easy way to directly add untyped properties to a resource in Microsoft Graph. El recurso openTypeExtension representa las extensiones abiertas.Open extensions are represented by the openTypeExtension resource. Las extensiones abiertas agregadas a un recurso se muestran en la propiedad de navegación extensions, que se deriva del tipo abstracto extension.Any open extension added to a resource shows up in the extensions navigation property, which is derived from the extension abstract type. 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.Each extension has an extensionName property which is the only pre-defined, writable property for all extensions, along with your custom data. 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.One way to help make sure extension names are unique is to use a reverse domain name system (DNS) format that is dependent on your own domain, for example, Com.Contoso.ContactInfo. No use el dominio de Microsoft (Com.Microsoft o Com.OnMicrosoft) en un nombre de extensión.Do not use the Microsoft domain (Com.Microsoft or Com.OnMicrosoft) in an extension name.

Ejemplo de extensión abierta: Agregar datos personalizados a los usuarios mediante extensiones abiertasOpen extension example: Add custom data to users using open extensions

Las extensiones abiertas son compatibles con los recursos siguientes en las versiones correspondientes: disponibilidad general (GA: /v1.0 y /beta) o en versión preliminar (/beta).Open extensions are supported by the following resources in the corresponding versions - general availability (GA: /v1.0 and /beta) or preview (/beta).

RecursoResource VersiónVersion
Unidad administrativaAdministrative unit Solo versión preliminarPreview only
Evento de calendarioCalendar event GAGA
Evento de calendario de grupoGroup calendar event GAGA
Publicación de subproceso de conversación de grupoGroup conversation thread post GAGA
devicedevice GAGA
groupgroup GAGA
messagemessage GAGA
organizationorganization GAGA
Contacto personalPersonal contact GAGA
useruser GAGA

Consideraciones específicas de OutlookOutlook-specific considerations

Cada extensión abierta presente en un recurso de Outlook (evento, mensaje o contacto personal) se almacena en una propiedad con nombre MAPI.Each open extension present on an Outlook resource (event, message, or personal contact) is stored in a MAPI named property. 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.When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. Cuando se agota la cuota de propiedad con nombre de un usuario, no puede crear más propiedades con nombre para ese usuario.When a user's named property quota is exhausted, you can't create any more named properties for that user. Esto puede provocar un comportamiento inesperado de los clientes que dependan de propiedades con nombre para funcionar.This can result in unexpected behavior from clients that rely on named properties to function.

Siga las siguientes instrucciones al crear extensiones abiertas en recursos de Outlook:Apply the following guidelines when you create open extensions on Outlook resources:

  • Cree el número mínimo de extensiones necesarias.Create the minimum number of extensions required. La mayoría de las aplicaciones no deberían requerir más de una extensión.Most applications should require no more than one extension. Las extensiones no tienen un conjunto de propiedades o estructuras definido para que pueda almacenar varios valores en una única extensión.Extensions have no set defined properties or structure, so you can store multiple values in a single extension.
  • Evite nombrar las extensiones de manera variable (por ejemplo basándose en las entradas del usuario, etcétera).Avoid naming extensions in a variable manner (such as based on user input, etc.). 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.Each time an open extension is created with a new name that has not been used in a user's mailbox before, a new MAPI named property is created. Quitar la extensión no elimina la propiedad con nombre.Removing the extension does not remove the named property.

Usar extensiones abiertas (para recursos de Outlook) o propiedades extendidasUse open extensions (for Outlook resources) or extended properties

Open Extensions es la solución recomendada para la mayoría de los escenarios que implican almacenar y acceder a datos personalizados.Open extensions is the recommended solution for most scenarios involving storing and accessing custom data. 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.If, however, you need to access custom data for Outlook MAPI properties that are not already exposed through the Microsoft Graph API metadata, you can use extended properties and its REST API. Puede comprobar las propiedades que exponen los metadatos en: https://graph.microsoft.com/v1.0/$metadata.You can verify which properties the metadata exposes at https://graph.microsoft.com/v1.0/$metadata.

Representación JSONJSON representation

Aquí tiene una representación JSON del recursoHere is a JSON representation of the resource

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

PropiedadesProperties

PropiedadProperty TipoType DescripciónDescription
extensionNameextensionName StringString Un identificador de texto único para una extensión de datos de tipo abierto. Necesario.A unique text identifier for an open type data extension. Required.
idid StringString Un identificador completo que concatena el tipo de extensión con el extensionName. Solo lectura.A fully qualified identifier that concatenates the extension type with the extensionName. Read-only.

RelacionesRelationships

NingunoNone

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
PostPost openTypeExtension (en una instancia de recurso existente) o un contacto, eventoo mensaje nuevo que contenga un objeto openTypeExtension.openTypeExtension(in an existing resource instance), or a new contact, event, or message that contains an openTypeExtension object. Cree un objeto openTypeExtension en una instancia de recursos nueva o existente.Create an openTypeExtension object in an existing or new resource instance.
GetGet openTypeExtensionopenTypeExtension Lea las propiedades y las relaciones del objeto openTypeExtension.Read properties and relationships of openTypeExtension object.
ActualizarUpdate openTypeExtensionopenTypeExtension Actualice el objeto openTypeExtension.Update openTypeExtension object.
EliminarDelete NingunoNone Elimine el objeto openTypeExtension.Delete openTypeExtension object.