Compartilhar via


tipo de recurso da comunidade

Namespace: microsoft.graph

Representa uma comunidade no Viva Engage que é um local central para conversações, ficheiros, eventos e atualizações para pessoas que partilham um interesse ou objetivo comum.

Todas as comunidades estão associadas a um grupo do Microsoft 365, mas o grupo não tem o mesmo ID que a comunidade. Para obter mais informações sobre a gestão de comunidades no Viva Engage, consulte Utilizar o microsoft API do Graph para trabalhar com Viva Engage.

Este recurso é um tipo aberto que permite propriedades adicionais para além das documentadas aqui.

Herda de entidade.

Methods

Método Tipo de retorno Descrição
List coleção de comunidade Obtenha uma lista dos objetos da comunidade Viva Engage e respetivas propriedades.
Create engagementAsyncOperation Crie uma nova comunidade no Viva Engage.
Get comunidade Leia as propriedades e relações de um objeto de comunidade .
Atualizar Nenhum(a) Atualize as propriedades de uma comunidade Viva Engage existente.
Delete Nenhum Elimine uma comunidade Viva Engage juntamente com todos os conteúdos do Microsoft 365 associados, incluindo o grupo ligado do Microsoft 365, o bloco de notas do OneNote e os planos do Planner.

Propriedades

Propriedade Tipo Descrição
description Cadeia de caracteres A descrição da comunidade. O comprimento máximo é de 1024 carateres.
displayName Cadeia de caracteres O nome da comunidade. O tamanho máximo é de 255 caracteres.
groupId Cadeia de caracteres O ID do grupo do Microsoft 365 que gere a associação desta comunidade.
id Cadeia de caracteres O identificador exclusivo da comunidade. Somente leitura. Herdado da entidade.
privacidade communityPrivacy Define o nível de privacidade da comunidade. Os valores possíveis são: public, private, unknownFutureValue.

valores communityPrivacy

Member Descrição
public Qualquer utilizador do inquilino pode aderir e participar na comunidade.
privado Um administrador da comunidade tem de adicionar utilizadores inquilinos à comunidade antes de poderem participar.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.

Relações

Relação Tipo Descrição
group group O grupo do Microsoft 365 que gere a associação desta comunidade.
owners Coleção user Os administradores da comunidade. Limitado a 100 utilizadores. Se esta propriedade não for especificada quando cria a comunidade, o utilizador que chama é automaticamente atribuído como proprietário da comunidade.

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.community",
  "description": "String",
  "displayName": "String",
  "groupId": "String",
  "id": "String (identifier)",
  "privacy": "String"
}