命名空间:microsoft.graph
表示内容发现的当前用户设置。 用户的首选项适用于以下资源:
导出存储在云中的用户的 Windows 设置和值:
- 获取用户的 windowsSetting 对象列表。
- 通过在筛选器查询中传递以下项之一,获取用户的 windowsSetting 对象的筛选列表:
管理工作时间和位置设置:
- 获取和更新用户的工作时间和位置首选项,以便进行计划和可用性管理。
- 访问针对灵活工作安排的工作计划重复和事件。
继承自 entity。 若要了解如何获取或更新用户设置,请参阅获取设置和更新设置。
该资源支持:
- 检查用户及用户的组织是否对内容发现做贡献。
- 为特定用户禁用或启用内容发现。 这也会禁用 Office Delve 中的文档。
注意
此终结点仅适用于用户。 无法将此终结点用于联系人。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 获取设置 | userSettings | 获取用户和组织设置。 |
| 更新设置 | userSettings | 更新用户当前的设置。 |
| 列出 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 设置。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| itemInsights | userInsightsSettings | 用户的会议小时见解可见性设置,以及在用户与 Microsoft 365 中的其他项目(例如文档或网站)之间派生的见解。 通过此导航属性获取 userInsightsSettings。 |
| windows | windowsSetting 集合 | 存储在云中的用户的 Windows 设置。 |
| workHoursAndLocations | workHoursAndLocationsSetting | 用户的工作时间设置以及日程安排和可用性管理的位置首选项。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"contributionToContentDiscoveryDisabled": false,
"contributionToContentDiscoveryAsOrganizationDisabled": false
}