Tipo de recurso openTypeExtension (extensões abertas)

Namespace: microsoft.graph

Representa extensões abertas (também conhecidas como extensões de tipo aberto e anteriormente conhecidas como extensões de dados do Office 365), uma opção de extensibilidade que fornece uma forma fácil de adicionar diretamente propriedades não digitadas a um recurso no 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 gravável predefinida para todas as extensões, juntamente com os 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 utilize o domínio Microsoft (com.microsoft ou com.onmicrosoft) num nome de extensão.

Deriva do tipo abstrato de extensão.

Os seguintes recursos suportam a extensão aberta:

• user
• group

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

Nota: * Devido a uma limitação de serviço existente, os delegados não podem criar eventos abertos anexados por extensões em calendários de caixa de correio partilhados. 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 num recurso do Outlook (evento, mensagem ou contacto pessoal) é armazenada numa propriedade com o nome 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 quota de propriedades nomeada de um utilizador está esgotada, já não pode criar propriedades nomeadas para esse utilizador. 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 propriedades ou estrutura definidas, pelo que pode armazenar múltiplos valores numa ú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 utilizado na caixa de correio de um utilizador, é criada uma nova propriedade mapi chamada. Remover a extensão não remove a propriedade com nome.

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

Extensões abertas são a solução recomendada para a maioria dos cenários que envolvem armazenar e acessar dados personalizados. No entanto, se precisar de aceder a dados personalizados para propriedades MAPI do Outlook que ainda não estejam expostas através dos metadados da Microsoft Graph API, pode utilizar propriedades expandidas e a respetiva API REST. Você pode verificar quais propriedades os metadados expõem na https://graph.microsoft.com/v1.0/$metadata.

Métodos

Propriedades

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

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

Conteúdo relacionado

• Adicionar dados personalizados a recursos usando extensões
• Adicionar dados personalizados aos usuários usando extensões abertas