tipo de recurso insightsSettings

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa configurações para calcular e gerenciar o retorno programático ou de exibição de um tipo específico de insights em uma organização. Os insights podem ser insights de contato, insights de itens, insights de horas de reunião ou insights de pessoas.

Os insights de contato representam sugestões inteligentes para organizar contatos de usuário no Microsoft 365. Programaticamente, os contatos do usuário são representados pelo recurso de contato . Um exemplo de insights de contato é mesclar sugestões para contatos duplicados, disponíveis para usuários finais no Outlook.

Insights de itens e insights de horas de reunião representam relações entre usuários e itens, como documentos, sites e outros tipos de conteúdo no Microsoft 365. Programaticamente, eles são representados pelo recurso itemInsights . Você pode obter documentos compartilhados com um usuário, tendências em torno de um usuário ou usados por um usuário. Você pode usar insightsSettings para personalizar as configurações de privacidade para calcular, exibir ou retornar insights de itens em uma organização.

Pessoas insights representam conexões de pessoas relevantes ou que trabalham entre si com base em suas relações públicas. Programaticamente, as pessoas individuais são representadas pelo recurso de pessoa . Você pode usar a API de pessoas para obter informações sobre as pessoas. Você pode usar insightsSettings para personalizar as configurações de privacidade para exibir ou retornar insights de pessoas.

Por outro lado, para insights de itens e insights de horas de reunião, você também pode gerenciar seu cálculo e visibilidade em um nível de usuário usando o recurso userInsightsSettings .

Métodos

Método	Tipo de retorno	Descrição
Listar contatoInsights	insightsSettings	Obtenha as propriedades do recurso insightsSettings para exibir insights de contato em uma organização.
Item de listaInsights	insightsSettings	Obtenha as propriedades do recurso insightsSettings para exibir insights de item em uma organização.
Listar pessoasInsights	insightsSettings	Obtenha as propriedades do recurso insightsSettings para exibir insights de pessoas em uma organização.
Atualizar insightsSettings	insightsSettings	Atualize as propriedades de um recurso insightsSettings para gerenciar a exibição ou o retorno do tipo de insights especificado, que pode ser insights de contato, insights de itens ou insights de pessoas.

Propriedades

Propriedade	Tipo	Descrição
isEnabledInOrganization	Booliano	true se os insights do tipo especificado estiverem habilitados para a organização; false se os insights do tipo especificado forem desabilitados para todos os usuários sem exceções. O padrão é true. Opcional.
disabledForGroup	Cadeia de caracteres	A ID de um grupo Microsoft Entra, do qual o tipo de insights especificado está desabilitado para seus membros. O padrão é empty. Opcional.

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "disabledForGroup": "String",
  "isEnabledInOrganization": "Boolean"
}