userSettings 资源类型

命名空间:microsoft.graph

表示内容发现的当前用户设置。 用户首选项适用于以下资源:

访问用户的 Exchange 设置。 获取 Exchange 设置的列表,包括属于用户的邮箱。

导出用户存储在云中的 Windows 设置和值:

管理工作时间和位置设置:

  • 获取和更新用户的工作时间和位置首选项,以进行日程安排和可用性管理。
  • 访问工作计划重复次数和发生次数,以实现灵活的工作安排。

继承自 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
}