Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Namespace: microsoft.graph
Represents the current user settings for content discovery. The user's preferences apply to the following resources:
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:
Manage work hours and location settings:
- Get and update a user's work hours and location preferences for scheduling and availability management.
- Access work plan recurrences and occurrences for flexible work arrangements.
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 Windows settings | windowsSetting collection | Get the windowsSetting objects and their properties for the signed in user. |
| Get work hours and locations | workHoursAndLocationsSetting | Get the properties and relationships of your own workHoursAndLocationsSetting. |
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. |
| windows | windowsSetting collection | The Windows settings of the user stored in the cloud. |
| workHoursAndLocations | workHoursAndLocationsSetting | The user's settings for work hours and location preferences for scheduling and availability management. |
JSON representation
The following JSON representation shows the resource type.
{
"contributionToContentDiscoveryDisabled": false,
"contributionToContentDiscoveryAsOrganizationDisabled": false
}