userSettings resource type
Namespace: microsoft.graph
The current user settings for content discovery.
Export users' Windows settings and values stored in a cloud.
- Get a list of the user's windowsSetting objects
- Get a filtered list of the user's windowsSetting objects by passing one of the following in the filter query:
Inherits from entity. To learn how to get or update user settings, see Get settings and Update settings.
This resource supports:
- Checking whether a user and the user's organization contribute to content discovery.
- Disabling or enabling content discovery for specific users. This also disables documents in Office Delve.
Note
This endpoint works only with users. You can't use this endpoint with contacts.
Methods
| Method | Return Type | Description |
|---|---|---|
| Get settings | userSettings | Get the user and organization settings. |
| Update settings | userSettings | Update the user current settings. |
| List | windowsSetting collection | Get the windowsSetting objects and their properties for the signed in user. |
Properties
| Property | Type | Description |
|---|---|---|
| contributionToContentDiscoveryAsOrganizationDisabled | Boolean | Reflects the organization level setting controlling delegate access to the trending API. When set to true, the organization doesn't have access to Office Delve. The relevancy of the content displayed in Microsoft 365, for example in Suggested sites in SharePoint Home and the Discover view in OneDrive for work or school is affected for the whole organization. This setting is read-only and can only be changed by administrators in the SharePoint admin center. |
| contributionToContentDiscoveryDisabled | Boolean | When set to true, the delegate access to the user's trending API is disabled. When set to true, documents in the user's Office Delve are disabled. When set to true, the relevancy of the content displayed in Microsoft 365, for example in Suggested sites in SharePoint Home and the Discover view in OneDrive for work or school is affected. Users can control this setting in Office Delve. |
| id | String | Unique identifier of the user setting. Read-only. Inherited from entity. |
| windows | windowsSetting collection | The Windows settings of the user stored in the cloud. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| itemInsights | userInsightsSettings | The user's settings for the visibility of meeting hour insights, and insights derived between a user and other items in Microsoft 365, such as documents or sites. Get userInsightsSettings through this navigation property. |
JSON representation
The following JSON representation shows the resource type.
{
"contributionToContentDiscoveryDisabled": false,
"contributionToContentDiscoveryAsOrganizationDisabled": false
}