Tipo de recurso openTypeExtension (extensões abertas)openTypeExtension resource type (open extensions)

Namespace: microsoft.graphNamespace: microsoft.graph

As extensões abertas (anteriormente conhecidas como extensões de dados do Office 365) oferecem uma maneira fácil de adicionar diretamente propriedades não tipadas a um recurso do 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.

Extensões abertas são representadas pelo recurso openTypeExtension.Open extensions are represented by the openTypeExtension resource. Qualquer extensão aberta adicionada a um recurso é mostrada na propriedade de navegação extensions, que deriva do tipo abstrato extension.Any open extension added to a resource shows up in the extensions navigation property, which is derived from the extension abstract type. Cada extensão tem uma propriedade extensionName, que é a única propriedade predefinida e gravável para todas as extensões, juntamente com seus dados personalizados.Each extension has an extensionName property which is the only pre-defined, writable property for all extensions, along with your custom data.

Um modo de garantir que os nomes de extensão sejam exclusivos é usar um formato reverso de DNS no sistema de nomes de domínio que dependa de seu próprio domínio, por exemplo, 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. Não use o domínio Microsoft (Com.Microsoft ou Com.OnMicrosoft) em um nome de extensão.Do not use the Microsoft domain (Com.Microsoft or Com.OnMicrosoft) in an extension name.

Exemplo de extensão aberta: Adicionar dados personalizados aos usuários usando extensões abertasOpen extension example: Add custom data to users using open extensions

As extensões abertas têm suporte nos recursos a seguir nas versões correspondentes - disponibilidade geral (GA: /v1.0 e /beta) ou visualização (/beta).Open extensions are supported by the following resources in the corresponding versions - general availability (GA: /v1.0 and /beta) or preview (/beta).

RecursoResource VersãoVersion
Unidade administrativaAdministrative unit Somente para visualizaçãoPreview only
Evento de calendárioCalendar event GAGA
Evento de calendário do grupoGroup calendar event GAGA
Postagem de thread de conversa do grupoGroup conversation thread post GAGA
devicedevice GAGA
groupgroup GAGA
messagemessage GAGA
organizationorganization GAGA
Contato pessoalPersonal contact GAGA
useruser GAGA

Considerações específicas do OutlookOutlook-specific considerations

Cada extensão aberta presente em um recurso do Outlook (evento, mensagem ou contato pessoal) é armazenada em uma propriedade MAPI.Each open extension present on an Outlook resource (event, message, or personal contact) is stored in a MAPI named property. Quando você cria extensões abertas no Outlook, considere que as propriedades MAPI são um recurso finito em uma caixa de correio do usuário.When you create open extensions for Outlook, consider that MAPI named properties are a finite resource in a user's mailbox. Quando a propriedade de cota de um usuário acabar, não será mais possível criar quaisquer propriedades nomeadas desse usuário.When a user's named property quota is exhausted, you can't create any more named properties for that user. Isso pode resultar em um comportamento inesperado de clientes que dependem de propriedades nomeadas para funcionar.This can result in unexpected behavior from clients that rely on named properties to function.

Aplique as seguintes diretrizes quando você criar extensões abertas em recursos do Outlook:Apply the following guidelines when you create open extensions on Outlook resources:

  • Crie um número mínimo de extensões necessárias.Create the minimum number of extensions required. A maioria dos aplicativos exigem não mais que uma extensão.Most applications should require no more than one extension. As extensões não têm um conjunto definido de propriedades nomeadas ou estrutura, para que seja possível armazenar vários valores em um única extensão.Extensions have no set defined properties or structure, so you can store multiple values in a single extension.
  • Evite renomear extensões de uma maneira variável (por exemplo, com base na entrada do usuário, etc.).Avoid naming extensions in a variable manner (such as based on user input, etc.). Sempre que uma extensão aberta é criada com um novo nome que não foi usado na caixa de correio do usuário, uma nova propriedade MAPI é criada.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. Remover a extensão não remove a propriedade nomeada.Removing the extension does not remove the named property.

Use extensões abertas (para recursos do Outlook) ou propriedades estendidasUse open extensions (for Outlook resources) or extended properties

Extensões abertas são a solução recomendada para a maioria dos cenários que envolvem armazenar e acessar dados personalizados.Open extensions are the recommended solution for most scenarios involving storing and accessing custom data. Se, no entanto, você precisar acessar dados personalizados para as propriedades do Outlook MAPI que já não estão expostos por meio dos metadados da API do Microsoft Graph, você pode usar as propriedades estendidas e sua 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. Você pode verificar quais propriedades os metadados expõem na https://graph.microsoft.com/v1.0/$metadata.You can verify which properties the metadata exposes at https://graph.microsoft.com/v1.0/$metadata.

Representação JSONJSON representation

Veja a seguir uma representação JSON do recurso.Here is a JSON representation of the resource.

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

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
extensionNameextensionName StringString Um identificador de texto exclusivo para uma extensão de tipo aberto. Obrigatório.A unique text identifier for an open type open extension. Required.
idid StringString Um identificador totalmente qualificado que concatena o tipo de extensão com extensionName. Somente leitura.A fully qualified identifier that concatenates the extension type with the extensionName. Read-only.

RelaçõesRelationships

NenhumaNone

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
CriarCreate openTypeExtension (em uma instância de recurso existente) ou um novo contact, event ou message que contenha um objeto openTypeExtensionopenTypeExtension (in an existing resource instance), or a new contact, event, or message that contains an openTypeExtension object Crie um objeto openTypeExtension em uma instância de recurso nova ou existente.Create an openTypeExtension object in an existing or new resource instance.
GetGet openTypeExtensionopenTypeExtension Leia propriedades e relações do objeto openTypeExtension.Read properties and relationships of openTypeExtension object.
UpdateUpdate openTypeExtensionopenTypeExtension Atualize o objeto openTypeExtension.Update openTypeExtension object.
DeleteDelete NenhumaNone Exclua um objeto openTypeExtension.Delete openTypeExtension object.