社区资源类型
命名空间：microsoft.graph
表示Viva Engage中的一个社区，该社区是共享共同兴趣或目标的人员进行对话、文件、事件和更新的中心位置。
每个社区都与 Microsoft 365 组相关联，但该组的 ID 与社区不同。 有关在 Viva Engage 中管理社区的详细信息，请参阅使用Microsoft图形 API Viva Engage。
此资源是允许传入其他属性的开放类型。
继承自 entity。
Methods
| 方法 | 返回类型 | Description |
|---|---|---|
| List | 社区 集合 | 获取Viva Engage社区对象及其属性的列表。 |
| 创建 | engagementAsyncOperation | 在 Viva Engage 中创建新的社区。 |
| Get | 社区 | 读取 社区 对象的属性和关系。 |
| 更新 | 无 | 更新现有Viva Engage社区的属性。 |
| 删除 | None | 删除Viva Engage社区以及所有相关Microsoft 365 内容，包括连接的 Microsoft 365 组、OneNote 笔记本和Planner计划。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 说明 | String | 社区的说明。 最大长度为 1,024 个字符。 |
| displayName | String | 社区的名称。 最大长度为 255 个字符。 |
| groupId | String | 管理此社区成员身份的 Microsoft 365 组 的 ID。 |
| id | String | 社区的唯一标识符。 只读。 继承自 entity。 |
| 隐私 | communityPrivacy | 定义社区的隐私级别。 可能的值包括 public、private、unknownFutureValue。 |
communityPrivacy 值
| 成员 | 说明 |
|---|---|
| 公开 | 租户中的任何用户都可以加入社区并参与社区。 |
| 私人 | 社区管理员必须先将租户用户添加到社区，然后他们才能参与。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 组 | 组 | Microsoft管理此社区成员身份的 365 组 。 |
| owners | user 集合 | 社区的管理员。 限制为 100 个用户。 如果在创建社区时未指定此属性，则会自动将调用用户分配为社区所有者。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.community",
"description": "String",
"displayName": "String",
"groupId": "String",
"id": "String (identifier)",
"privacy": "String"
}