You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/embedded/concepts/content-experiences/user-experiences-overview.md
+15-16Lines changed: 15 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ ms.date: 11/14/2023
5
5
ms.localizationpriority: high
6
6
---
7
7
8
-
# Content Experiences Overview
8
+
# User Experiences Overview
9
9
10
10
Microsoft's SharePoint Embedded provides a comprehensive set of Content Experience features like Open & Edit of Office Files, File Preview or In-App Search that you can use to build the right user experiences for your applications.
11
11
@@ -36,23 +36,26 @@ Integrate your app with SharePoint Embedded player plugin to offer File Preview
36
36
37
37
You can use [Microsoft Graph's Download DriveItem API](/graph/api/driveitem-get-content) to offer download file user experiences for your applications. This will generate a short lived, preauthenticated Url allows users to download files from your applications.
38
38
39
-
> [!NOTE]
40
-
> A direct link to the file lacks the appropriate authorization from your app. If used directly in a browser, this would yield an access denied.
39
+
Note the following:
41
40
42
-
## In-Application Search
43
-
44
-
You can use the Microsoft Search API to query SharePoint Embedded services container content in your application. Search requests run in the context of the signed-in user. Search results are only scoped to enforce any access control applied to the items by the user. For example, search results will include all content matching the search criteria and accessible by the user regardless of whether the SharePoint Embedded application is authorized to access the content. It's recommended to specify the container type accessible by the application in the search request body to ensure search results are properly scoped.
41
+
A direct link to the file lacks the appropriate authorization from your app. If used directly in a browser, this would yield an access denied.
45
42
46
43
## Content Discovery in Microsoft 365
47
44
48
-
Your users will be able to discover and share content from your SharePoint Embedded applications in their Recommended, Quick Access or Shared With Me feeds on Microsoft 365 surfaces like Office.com, SharePoint Search results or OneDrive user accounts. This allows your users to use familiar Microsoft 365 experiences to discover content from your applications. In future releases, Microsoft 365 Content Discovery can be configured to be disabled across all Microsoft 365 surfaces.
45
+
You can control how your content appears in the Microsoft 365 experience. The default behavior is SharePoint Embedded app content will be hidden everywhere in Microsoft 365 environment including office.com, oneDrive.com, the Copilot experience or other Microsoft intelligent file discovery features.
49
46
50
-
### Enable Sharing dialog in Office.com
47
+
If you want to opt into the Microsoft 365 experience, during container type creation, you can change the default settings using cmdlet [Set-SPOContainerTypeConfiguration](/powershell/module/sharepoint-online/set-SPOContainerTypeConfiguration) as per this example:
48
+
```powershell
49
+
Set-SPOContainerTypeConfiguration
50
+
-ContainerTypeID <Identifier>
51
+
-discoverabilityDisabled $False
52
+
```
53
+
In this way, your files will be integrated into the Microsoft365 environment, participating in intelligent file discovery and Copilot experiences.
51
54
52
-
> [!NOTE]
53
-
> To enable the sharing user experience for your content in Office.com additional application permissions **must** be added at the time of the container type registration process.
55
+
Note the following:
54
56
55
-
To add more permission to enable sharing dialog, refer to the following code:
57
+
1. If you modify the settings after creating some content, it may take up to 30 days for these changes to achieve full consistency across all consuming tenants.
58
+
2. To enable the sharing user experience for your content in Office.com, additional application permissions **must** be added at the time of the container type registration process. To add more permission to enable sharing dialog, refer to the following code:
56
59
57
60
```http
58
61
PUT /storageContainerTypes/{containerTypeId}/applicationPermissions
@@ -67,8 +70,4 @@ Content-Type: application/json
67
70
68
71
## Recycle Bin
69
72
70
-
You can use the Microsoft Graph APIs to either soft-delete or permanent-delete items in containers. Soft-deleted items are moved to the container’s recycle bin and retained for 93 days. During this period, the items can be restored or permanently deleted using the Microsoft Graph APIs. An item in recycle bin is permanently deleted when it exceeds the 93-day retention period. Permanently deleted items can't be restored.
71
-
72
-
## Deleted Container Collection
73
-
74
-
You can use the SharePoint Embedded services container Graph API to delete containers and move them into the deleted container collection. A deleted container can be restored from the collection within 93 days. If a container is deleted from the collection, or it exceeds the 93-day retention period, it's permanently deleted.
73
+
You can use the Microsoft Graph to either soft-delete or permanent-delete items in containers. Soft-deleted items are moved to the container’s recycle bin and retained for 93 days. During this period, the items can be restored or permanently deleted using the Microsoft Graph APIs. An item in recycle bin is permanently deleted when it exceeds the 93-day retention period. Permanently deleted items can't be restored.
0 commit comments