大网数据广告活动
Microsoft Graph 接口

更新设置

· 52CE 我爱测

更新 userSettings 对象的 属性。 同一组织中的用户可以根据首选项或组织策略具有不同的设置。 若要获取用户当前设置,请参阅 当前用户设置。

命名空间:microsoft.graph

更新 userSettings 对象的 属性。 同一组织中的用户可以根据首选项或组织策略具有不同的设置。 若要获取用户当前设置,请参阅 当前用户设置。

批量请求

也可以从 Delve 中选择退出多个用户,并通过批量请求禁用他们对整个组织内容相关性的贡献。 若要了解详细信息,请参阅 JSON 批处理。

重要 提示:只有 组织管理 角色组的成员才能更新多个用户。

权限

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) User.ReadWrite、User.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。
应用程序 User.ReadWrite.All

HTTP 请求

PATCH /me/settings

具有“用户ID”或“userPrincipalName”的请求只能由用户或具有 User.ReadWrite.All 权限的用户访问。若要了解详细信息,请参阅权限。

PATCH /users/{id | userPrincipalName}/settings/

请求标头

标头 值
Authorization Bearer {token}。必需。
Content-Type application/json

请求正文

在请求正文中,提供应更新的相关字段的值。请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。为了获得最佳性能,不应包括尚未更改的现有值。

属性 类型 说明
contributionToContentDiscoveryDisabled 布尔值 设置为 true 会禁用对趋势 API 的 委托访问,并禁用对用户 Office Delve 中文档的访问权限。 设置为 true 也会影响 Microsoft 365 中显示的内容的相关性 ,例如,SharePoint 主页中的建议网站和OneDrive for Business中的发现视图显示不太相关的结果。 此设置反映 Office Delve 中的控件状态。

示例

请求

下面是一个示例请求,说明如何从 Delve 中选择退出用户,并禁用他对整个组织内容相关性的贡献。

PATCH https://graph.microsoft.com/v1.0/me/settings
Content-type: application/json

{
  "contributionToContentDiscoveryDisabled": true
}
响应

这是一个示例响应。注意:为提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-type: application/json

{
  "contributionToContentDiscoveryAsOrganizationDisabled": false,
  "contributionToContentDiscoveryDisabled": true
}

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 jpettere)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。