Поделиться через

Тип ресурса community

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет сообщество в Viva Engage, которое является центральным местом для бесед, файлов, событий и обновлений для людей, разделяющих общие интересы или цели.

Каждое сообщество связано с группой Microsoft 365, но у группы нет того же идентификатора, что и у сообщества. Дополнительные сведения об управлении сообществами в Viva Engage см. в статье Использование API Microsoft Graph для работы с Viva Engage.

Этот ресурс относится к открытому типу, который позволяет передавать другие свойства.

Наследует от сущности.

Методы

Метод Тип возвращаемых данных Описание
Список коллекция community Получите список объектов сообщества Viva Engage и их свойств.
Создание engagementAsyncOperation Создайте новое сообщество в Viva Engage.
Получение сообщество Чтение свойств и связей объекта сообщества .
Обновление Нет Обновите свойства существующего сообщества Viva Engage.
удаление; Нет Удалите сообщество Viva Engage, а также все связанное содержимое Microsoft 365, включая подключенную группу Microsoft 365, записную книжку OneNote и планы Планировщика.

Свойства

Свойство Тип Описание
description String Описание сообщества. Максимальная длина — 1024 символа.
displayName String Имя сообщества. Максимальная длина: 255 символов.
groupId String Идентификатор группы Microsoft 365 , которая управляет членством в этом сообществе.
id String Уникальный идентификатор сообщества. Только для чтения. Наследуется от сущности.
конфиденциальность communityPrivacy Определяет уровень конфиденциальности сообщества. Допустимые значения: public, private, unknownFutureValue.

значения communityPrivacy

Member Описание
public Любой пользователь из клиента может присоединиться к сообществу и участвовать в нем.
частный Администратор сообщества должен добавить пользователей клиента в сообщество, прежде чем они смогут участвовать.
unknownFutureValue Изменяемое значение перечисления sentinel. Не используйте.

Связи

Связь Тип Описание
group; group Группа Microsoft 365, управляющая членством в этом сообществе.
owners Коллекция объектов user Администраторы сообщества. Ограничено 100 пользователями. Если это свойство не указано при создании сообщества, вызывающий пользователь автоматически назначается в качестве владельца сообщества.

Представление JSON

В следующем представлении JSON показан тип ресурса.

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

Связанные материалы