社区资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示 Viva Engage 中的一个社区，该社区是共享共同兴趣或目标的人员进行对话、文件、活动和更新的中心位置。
每个社区都与 Microsoft 365 组相关联，但该组的 ID 与社区不同。 有关在 Viva Engage 中管理社区的详细信息，请参阅 使用 Microsoft Graph 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"
}