命名空间:microsoft.graph
表示内容发现的当前用户设置。 用户首选项适用于以下资源:
访问用户的 Exchange 设置。 获取 Exchange 设置的列表,包括属于用户的邮箱。
导出用户存储在云中的 Windows 设置和值:
- 获取用户的 windowsSetting 对象的列表。
- 通过在筛选查询中传递以下内容之一,获取用户的 windowsSetting 对象的筛选列表:
管理工作时间和位置设置:
- 获取和更新用户的工作时间和位置首选项,以进行日程安排和可用性管理。
- 访问工作计划重复次数和发生次数,以实现灵活的工作安排。
继承自 entity。 若要了解如何获取或更新用户设置,请参阅获取设置和更新设置。
该资源支持:
- 检查用户及用户的组织是否对内容发现做贡献。
- 为特定用户禁用或启用内容发现。 这也会禁用 Office Delve 中的文档。
注意
此终结点仅适用于用户。 无法将此终结点用于联系人。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 获取设置 | userSettings | 获取用户和组织设置。 |
| 更新设置 | userSettings | 更新用户当前的设置。 |
| 列出 Exchange 设置 | exchangeSettings 集合 | 获取属于用户的 Exchange 邮箱列表。 |
| 列出 Windows 设置 | windowsSetting 集合 | 获取已登录用户的 windowsSetting 对象及其属性。 |
| 获取工作时间和位置 | workHoursAndLocationsSetting | 获取用户的 workHoursAndLocationsSetting 的属性和关系。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| contributionToContentDiscoveryAsOrganizationDisabled | 布尔值 | 反映用于控制至趋势 API 的委托访问的组织级别设置。 如果设为 true,则组织没有 Office Delve 的访问权限。 Microsoft 365 中显示的内容的相关性(例如,在 SharePoint 主页中的建议网站和 OneDrive(工作或学校)中的“发现”视图中,会对整个组织造成影响。 此设置为只读,并且仅可由管理员在 SharePoint 管理中心更改。 |
| contributionToContentDiscoveryDisabled | 布尔值 | 如果设为 true,则会禁用至用户的趋势 API 的委托访问。 如果设为 true,则用户的 Office Delve 中的文档将禁用。 设置为 true 时,Microsoft 365 中显示的内容的相关性会受到影响,例如在 SharePoint 主页的建议网站和 OneDrive 工作或学校中的“发现”视图中。 用户可以在 Office Delve 中控制此设置。 |
| id | 字符串 | 用户设置的唯一标识符。 只读。 继承自 entity。 |
| windows | windowsSetting 集合 | 存储在云中的用户的 Windows 设置。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 交换 | exchangeSettings | 邮箱发现的 Exchange 设置。 |
| itemInsights | userInsightsSettings | 用户对会议时间见解以及用户与 Microsoft 365 中的其他项目(如文档或网站)之间派生的见解可见性的设置。 通过此导航属性获取 userInsightsSettings。 |
| windows | windowsSetting 集合 | 存储在云中的用户的 Windows 设置。 |
| workHoursAndLocations | workHoursAndLocationsSetting | 用户对工作时间的设置以及用于调度和可用性管理的位置首选项。 |
JSON 表示形式
以下 JSON 表示形式显示资源类型。
{
"contributionToContentDiscoveryDisabled": false,
"contributionToContentDiscoveryAsOrganizationDisabled": false
}