命名空间:microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示用户对以下内容的首选项的设置:
- 访问 Delve
- Exchange 设置
- 项见解
- 区域设置和语言
- 排班计划
- 合并重复联系人的建议
- 工作时间和位置
此资源类型提供对以下作的访问权限。
管理 Delve 辅助功能:
- 确定用户和用户的组织是否有权访问 Office Delve。
- 在 Office Delve 中为特定用户禁用或启用文档。
配置 itemInsights 和 会议小时数见解的可见性。 项目见解在用户和其他项之间派生, (如 Microsoft 365 中的文档或网站) :
- 确定是否启用了用户的项和会议小时数见解。
- 为特定用户禁用或启用项目和会议小时数见解。
管理基于区域设置的用户首选项:
- 确定用户喜欢使用哪种语言和区域格式查看应用程序。
- 更新用户的语言和区域格式首选项。
管理用户的工作轮班首选项:
- 确定是否可将用户分配到计划中的班次。
- 更新用户的排班首选项。
- 确定是否启用合并用户重复联系人的建议。
- 禁用或启用用于合并用户重复联系人的建议。
访问用户的 Exchange 设置。 获取 Exchange 设置的列表,包括属于用户的邮箱。
导出存储在云中的用户的 Windows 设置和值:
- 获取用户的 windowsSetting 对象列表。
- 通过在筛选器查询中传递以下项之一,获取用户的 windowsSetting 对象的筛选列表:
管理工作时间和位置设置:
- 获取和更新用户的工作时间和位置首选项,以便进行计划和可用性管理。
- 访问针对灵活工作安排的工作计划重复和事件。
继承自 entity。
注意
此终结点仅适用于 用户 资源。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| Get | userSettings | 获取用户和组织设置。 |
| 更新 | userSettings | 更新用户当前的设置。 |
| 列出 Exchange 设置 | exchangeSettings 集合 | 获取 Exchange 设置的列表,包括属于用户的邮箱。 |
| 列出 Windows 设置 | windowsSetting 集合 | 获取已登录用户的 windowsSetting 对象及其属性。 |
| 获取工作时间和位置 | workHoursAndLocationsSetting | 获取自己的 workHoursAndLocationsSetting 的属性和关系。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| contributionToContentDiscoveryDisabled | 布尔值 | 如果设为 true,则用户的 Office Delve 中的文档将禁用。 用户可以在 Office Delve 中控制此设置。 |
| contributionToContentDiscoveryAsOrganizationDisabled | 布尔值 | 反映 Office Delve 组织级别设置。 如果设为 true,则组织没有 Office Delve 的访问权限。 此设置为只读,并且仅可由管理员在 SharePoint 管理中心更改。 |
| id | 字符串 | 用户设置的唯一标识符。 只读。 继承自 entity。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| contactMergeSuggestions | contactMergeSuggestions | 用户针对用户联系人列表中的重复联系人的合并建议可见性设置。 |
| 交换 | exchangeSettings | 邮箱发现的 Exchange 设置。 |
| itemInsights | userInsightsSettings | 用户的会议小时见解可见性设置,以及在用户与 Microsoft 365 中的其他项目(例如文档或网站)之间派生的见解。 通过此导航属性获取 userInsightsSettings。 |
| regionalAndLanguageSettings | regionalAndLanguageSettings | 用户对语言、区域设置和日期/时间格式的首选项。 |
| shiftPreferences | shiftPreferences | 用户的排班首选项。 |
| windows | windowsSetting 集合 | 存储在云中的用户的 Windows 设置。 |
| workHoursAndLocations | workHoursAndLocationsSetting | 用户的工作时间设置以及日程安排和可用性管理的位置首选项。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"contributionToContentDiscoveryDisabled": false,
"contributionToContentDiscoveryAsOrganizationDisabled": false
}