Tipo de recurso openTypeExtension (extensões abertas)

Artigo
07/01/2022
3 minutos para o fim da leitura

Namespace: microsoft.graph

Representa as extensões abertas (anteriormente conhecidas como extensões de dados do Office 365), uma opção de extensibilidade que fornece uma maneira fácil de adicionar propriedades não tipadas diretamente a um recurso do Microsoft Graph.

Qualquer extensão aberta adicionada a um recurso é mostrada na propriedade de navegação extensões.. 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. 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. Não use o domínio Microsoft (com.microsoft ou com.onmicrosoft ) em um nome de extensão.

Deriva do tipo abstrato de extensão.

As extensões abertas são compatíveis com os recursos a seguir.

user
group

contact
device
evento para calendários de usuário e grupo
message
organização
postagem
todoTask
todoTaskList

Observação *: devido a uma limitação de serviço existente, os representantes não podem criar eventos abertos acrescentados à extensão em calendários de caixa de correio compartilhados. As tentativas de fazer isso resultarão em uma resposta de ErrorAccessDenied.

Para obter mais informações sobre a extensibilidade do Microsoft Graph, incluindo limites para extensões abertas, consulte Adicionar propriedades personalizadas aos recursos usando extensões e Adicionar dados personalizados aos usuários usando extensões abertas.

Considerações específicas do Outlook

Cada extensão aberta presente em um recurso do Outlook (evento, mensagem ou contato pessoal) é armazenada em uma propriedade MAPI. 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. Quando a propriedade de cota de um usuário acabar, não será mais possível criar quaisquer propriedades nomeadas desse usuário. Isso pode resultar em um comportamento inesperado de clientes que dependem de propriedades nomeadas para funcionar.

Aplique as seguintes diretrizes quando você criar extensões abertas em recursos do Outlook:

Crie um número mínimo de extensões necessárias. A maioria dos aplicativos exigem não mais que uma extensão. 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.
Evite renomear extensões de uma maneira variável (por exemplo, com base na entrada do usuário, 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. Remover a extensão não remove a propriedade nomeada.

Use extensões abertas (para recursos do Outlook) ou propriedades estendidas

As extensões abertas são a solução recomendada para a maioria dos cenários que envolvem armazenar e acessar dados personalizados. 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. Você pode confirmar quais propriedades os metadados expõem em https://graph.microsoft.com/v1.0/$metadata.

Métodos

Método	Tipo de retorno	Descrição
Criar	openTypeExtension (em uma instância de recurso existente), ou um novo todoTask, todoTaskList, contato, evento, mensagem, ou postagemt, todoTask ou todoTaskListque contém um objeto OpenTypeExtension.	Crie um objeto openTypeExtension em uma instância de recurso nova ou existente.
Get	openTypeExtension	Leia propriedades e relações do objeto openTypeExtension.
Update	openTypeExtension	Atualize o objeto openTypeExtension.
Delete	Nenhuma	Exclua um objeto openTypeExtension.

Propriedades

Propriedade	Tipo	Descrição
extensionName	String	Um identificador de texto exclusivo para uma extensão de dados de tipo aberto. Obrigatório.
id	String	Um identificador totalmente qualificado que concatena o tipo de extensão com extensionName. Somente leitura.

Relações

Nenhum

Representação JSON

Veja a seguir uma representação JSON do recurso.

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