更新设置

命名空间：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
}