Skip to content

Commit 236b420

Browse files
authored
Merge pull request #26043 from microsoftgraph/remove-delve-mentions
Remove Delve mentions from Item Insights docs
2 parents 66c94dd + 1168213 commit 236b420

7 files changed

+35
-36
lines changed

api-reference/beta/resources/iteminsights.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Insights are returned by the following APIs:
2222
- [Trending](insights-trending.md) - returns documents from OneDrive for work or school and from SharePoint sites trending around a user.
2323
- [Used](insights-used.md) - returns documents viewed and modified by a user. Includes documents the user used in OneDrive for work or school, and SharePoint.
2424

25-
Each insight is returned with a **resourceVisualization** and **resourceReference** complex value type (CVT). The **resourceVisualization** CVT contains properties such as **title** and **previewImageUrl**. Microsoft uses the visualization properties to render the files in experiences like Office Delve.
25+
Each insight is returned with a **resourceVisualization** and **resourceReference** complex value type (CVT). The **resourceVisualization** CVT contains properties such as **title** and **previewImageUrl**. Microsoft uses the visualization properties to render the files in experiences like Microsoft365.com.
2626

2727
### Limiting item insights
2828

api-reference/v1.0/resources/iteminsights.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Insights are returned by the following APIs:
2020
- [Trending](insights-trending.md) - returns documents from OneDrive for work or school and from SharePoint sites trending around a user.
2121
- [Used](insights-used.md) - returns documents viewed and modified by a user. Includes documents the user used in OneDrive for work or school and SharePoint.
2222

23-
Each insight is returned with a **resourceVisualization** and **resourceReference** complex value type (CVT). The **resourceVisualization** CVT contains properties such as **title** and **previewImageUrl**. Microsoft uses the visualization properties to render the files in experiences like Office Delve.
23+
Each insight is returned with a **resourceVisualization** and **resourceReference** complex value type (CVT). The **resourceVisualization** CVT contains properties such as **title** and **previewImageUrl**. Microsoft uses the visualization properties to render the files in experiences like Microsoft365.com.
2424

2525
### Limiting item insights
2626

Loading
Loading
Loading

concepts/insights-customize-item-insights-privacy.md

Lines changed: 8 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.date: 11/07/2024
1212

1313
Item insights are relationships that Microsoft calculates using advanced machine learning techniques. When users collaborate over documents, SharePoint sites and lists, Teams chats and channels, Microsoft aggregates these activities as signals. From these signals, Microsoft derives insights to make user-centric content recommendations for users in an organization.
1414

15-
Item insights can help users quickly find files that matter to them, such as in the **Recommended** experience in Office.com and Delve. Users can discover in the **Discover** area in Outlook Mobile potentially useful content to which they have access but might not have seen before. From personalized insights such as **Recent files** in a persona card in Bing and **Recent** in Microsoft 365 apps, users can easily discover their recent files.
15+
Item insights can help users quickly find files that matter to them, such as in the **Recommended** experience in Microsoft365.com. Users can see potentially useful content to which they have access but might not have seen before in the **Discover** area in Outlook Mobile or the **Recent** section under a name in Bing. Users can easily discover their recent files from personalized insights such as **Recent files** in a persona card in Bing and **Recent** in Microsoft 365 apps.
1616

1717
These item insights reflect only content to which users have access. No user gets recommendations to content that they can't access.
1818

@@ -21,7 +21,7 @@ These item insights reflect only content to which users have access. No user get
2121
2222
## Item insights privacy
2323

24-
Item insights privacy settings configure the visibility of insights derived from Microsoft Graph between users and other items (such as documents or sites) in Microsoft 365. You can disable the Delve app via the pre-existing controls, but allow other insights-based experiences to continue to provide assistance.
24+
Item insights privacy settings configure the visibility of insights derived from Microsoft Graph between users and other items (such as documents or sites) in Microsoft 365.
2525

2626
There are a few ways to customize users' item insights privacy settings:
2727

@@ -37,9 +37,9 @@ The rest of this article describes how an administrator can customize item insig
3737

3838
## Background
3939

40-
At the time of first release in 2014, Office Graph was a backend service for Delve. They shared a set of privacy controls over both the Office Graph insights and the Delve user experience. Office Graph has since become more independent and powerful, as part of every Microsoft 365 experience and of Microsoft Graph. To offer a coherent Microsoft Graph schema, Microsoft introduced an [itemInsights](/graph/api/resources/iteminsights?view=graph-rest-1.0&preserve-view=true) entity, which inherits all the properties of the pre-existing [officeGraphInsights](/graph/api/resources/officegraphinsights?view=graph-rest-1.0&preserve-view=true) resource, and has kept **officeGraphInsights** around for backward compatibility. The introduction of **itemInsights** also decouples the privacy story for the two independent pieces.
40+
At the time of its first release in 2014, Microsot Graph was a backend service for Delve. (Delve was deprecated in December 2024.) They shared a set of privacy controls over both the Office Graph insights and the Delve user experience. Microsoft Graph has since become more independent and powerful, as part of every Microsoft 365 experience and of Microsoft Graph. To offer a coherent Microsoft Graph schema, Microsoft introduced an [itemInsights](/graph/api/resources/iteminsights?view=graph-rest-1.0&preserve-view=true) entity, which inherits all the properties of the pre-existing [officeGraphInsights](/graph/api/resources/officegraphinsights?view=graph-rest-1.0&preserve-view=true) resource, and has kept **officeGraphInsights** around for backward compatibility. The introduction of **itemInsights** also decouples the privacy story for the two independent pieces.
4141

42-
Although existing apps can continue to use **officeGraphInsights**, they should upgrade to **itemInsights** to gain the flexibility to fine-tune item insights in Office Graph and Delve.
42+
Although existing apps can continue to use **officeGraphInsights**, they should upgrade to **itemInsights** to gain the flexibility to fine-tune item insights in Microsoft Graph.
4343

4444
## How to customize item insights in an organization
4545

@@ -51,11 +51,11 @@ The next section describes how to use the admin center to configure item insight
5151

5252
An administrator with the _global administrator role_ can tune item insights privacy settings via toggles for an organization or group. To change privacy settings for item insights in the Microsoft 365 admin center, expand **Settings**, select **Search & intelligence**, then select **Configurations**. In the **Item insights** tile, choose **Change**.
5353

54-
![admincenter_toggleoverview](images/itemInsights/iteminsights_admincenter_toggleoverview.png)
54+
!["Search & intelligence" page in the M365 Admin Center, with the "Configurations" tab selected. Item insights, the right-most tile, shows "Active".](images/itemInsights/iteminsights_admincenter_toggleoverview.png)
5555

5656
Then toggle item insights for your organization, or enable it or disable it for specific groups.
5757

58-
![admincenter_toggledetails](images/itemInsights/iteminsights_admincenter_toggledetails.png)
58+
!["Item insights" pane. "Allow your organization to use item insights" is checked. "Disable group (optional)" is populated with "test site".](images/itemInsights/iteminsights_admincenter_toggledetails.png)
5959

6060
### Configure item insights settings via PowerShell
6161

@@ -110,7 +110,7 @@ Use the [update](/graph/api/insightssettings-update?view=graph-rest-1.0&preserve
110110
| Disabled for the entire organization | `false` | ignored |
111111

112112
Keep the following points in mind when updating item insights settings:
113-
- Get the ID of a Microsoft Entra group from the Microsoft Entra admin center, and make sure the group exists, because the update operation doesn't check the existence of the group. Specifying a nonexistent group in **disabledForGroup** doesn't_ disable insights for any users in the organization.
113+
- Get the ID of a Microsoft Entra group from the Microsoft Entra admin center, and make sure the group exists, because the update operation doesn't check the existence of the group. Specifying a nonexistent group in **disabledForGroup** doesn't disable insights for any users in the organization.
114114
- Regardless of item insights settings, Delve continues to respect Delve tenant and user level [privacy settings](/sharepoint/delve-for-office-365-admins#control-access-to-delve-and-related-features?view=graph-rest-beta&preserve-view=true).
115115

116116

@@ -120,14 +120,8 @@ For a full list of experiences affected when disabling item insights, see [Overv
120120
## Transition period
121121
To accommodate configuring item insights settings, through the end of 2020, Microsoft 365 respects both Delve settings and item insights settings, and enforces the stricter of the two if they differ. This means that a user is considered as opted out of item insights if the user opted out by either Delve controls or item insights settings.
122122

123-
After this transition period, Delve settings control only the Delve experience, and item insights settings affect only Microsoft Graph item insights. Make sure to configure item insights according to your organization's requirements.
123+
After this transition period, Delve settings controlled only the Delve experience, and item insights settings affect only Microsoft Graph item insights. Make sure to configure item insights according to your organization's requirements. (Delve was deprecated in December 2024.)
124124

125125

126126
> [!NOTE]
127127
> During the transition period, due to technical reasons, the SharePoint start page may provide stale suggestions if an organization disables item insights for all users. This issue will be addressed in upcoming server-side changes.
128-
129-
## Related content
130-
Learn more about Delve and using Delve feature settings to control documents showing up in the **Discover** feed:
131-
- [Connect and collaborate in Office Delve](https://support.microsoft.com/office/connect-and-collaborate-in-office-delve-46f92806-b52c-4187-b60e-b3bf8d25f73e)
132-
- [Are my documents safe in Office Delve?](https://support.microsoft.com/office/are-my-documents-safe-in-office-delve-f5f409a2-37ed-4452-8f61-681e5e1836f3)
133-
- [Delve for admins](/sharepoint/delve-for-office-365-admins)

0 commit comments

Comments
 (0)