Merge pull request #112568 from Juliako/patch-29

Update video-indexer-embed-widgets.md

Author: PMEds28

articles/media-services/video-indexer/regions.md

@@ -18,7 +18,7 @@ Video Indexer APIs contain a **location** parameter that you should set to the A
 
 ## Locations
 
-The **location** parameter must be given the Azure region code name as its value. If you are using Video Indexer in preview mode, you should put *"trial"* as the value. Otherwise, to get the code name of the Azure region that your account is in and that your call should be routed to, you can run the following line in [Azure CLI](/cli/azure):
+The `location` parameter must be given the Azure region code name as its value. If you are using Video Indexer in preview mode, you should put `"trial"` as the value. `trial` is the default value for the `location` parameter. Otherwise, to get the code name of the Azure region that your account is in and that your call should be routed to, you can run the following line in [Azure CLI](/cli/azure):
 
 ```azurecli-interactive
 az account list-locations

articles/media-services/video-indexer/video-indexer-embed-widgets.md

@@ -16,7 +16,7 @@ ms.author: juliako
 
 This article shows how you can embed Video Indexer widgets in your apps. Video Indexer supports embedding three types of widgets into your apps: *Cognitive Insights*, *Player*, and *Editor*.
 
-Starting with version 2, the widget base URL includes the region of the specified account. For example, an account in the West US region generates: `https://wus2.videoindexer.ai/embed/insights/...`.
+Starting with version 2, the widget base URL includes the region of the specified account. For example, an account in the West US region generates: `https://www.videoindexer.ai/embed/insights/.../?location=westus2`.
 
 ## Widget types
 
@@ -31,6 +31,7 @@ A Cognitive Insights widget includes all visual insights that were extracted fro
 |`language`|A short language code (language name)|Controls insights language.<br/>Example: `https://www.videoindexer.ai/embed/insights/<accountId>/<videoId>/?language=es-es` <br/>or `https://www.videoindexer.ai/embed/insights/<accountId>/<videoId>/?language=spanish`|
 |`locale` | A short language code | Controls the language of the UI. The default value is `en`. <br/>Example: `locale=de`.|
 |`tab` | The default selected tab | Controls the **Insights** tab that's rendered by default. <br/>Example: `tab=timeline` renders the insights with the **Timeline** tab selected.|
+|`location` ||The `location` parameter must be included in the embedded links, see [how to get the name of your region](regions.md). If your account is in preview, the `trial` should be used for the location value. `trial` is the default value for the `location` parameter.| 
 
 ### Player widget
 
@@ -44,6 +45,7 @@ You can use the Player widget to stream video by using adaptive bit rate. The Pl
 |`type`| | Activates an audio player skin (the video part is removed).<br/> Example: `type=audio`. |
 |`autoplay` | A Boolean value | Indicates if the player should start playing the video when loaded. The default value is `true`.<br/> Example: `autoplay=false`. |
 |`language`/`locale` | A language code | Controls the player language. The default value is `en-US`.<br/>Example: `language=de-DE`.|
+|`location` ||The `location` parameter must be included in the embedded links, see [how to get the name of your region](regions.md). If your account is in preview, the `trial` should be used for the location value. `trial` is the default value for the `location` parameter.| 
 
 ### Editor widget
 
@@ -54,24 +56,29 @@ You can use the Editor widget to create new projects and manage a video's insigh
 |`accessToken`<sup>*</sup> | String | Provides access to videos that are only in the account that's used to embed the widget.<br> The Editor widget requires the `accessToken` parameter. |
 |`language` | A language code | Controls the player language. The default value is `en-US`.<br/>Example: `language=de-DE`. |
 |`locale` | A short language code | Controls the insights language. The default value is `en`.<br/>Example: `language=de`. |
+|`location` ||The `location` parameter must be included in the embedded links, see [how to get the name of your region](regions.md). If your account is in preview, the `trial` should be used for the location value. `trial` is the default value for the `location` paramete.| 
 
 <sup>*</sup>The owner should provide `accessToken` with caution.
 
-## Embedding public content
+## Embedding videos
 
-1. Sign in to the [Video Indexer](https://www.videoindexer.ai/) website.
-2. Select the video that you want to work with.
-3. Select the embed button (**</>**) that appears under the video.
+This section discusses embedding the public and private content into apps.
+
+The `location` parameter must be included in the embedded links, see [how to get the name of your region](regions.md). If your account is in preview, the `trial` should be used for the location value. `trial` is the default value for the `location` paramete. For example: `https://www.videoindexer.ai/accounts/00000000-0000-0000-0000-000000000000/videos/b2b2c74b8e/?location=trial`.
+
+> [!IMPORTANT]
+> Sharing a link for the **Player** or **Insights** widget will include the access token and grant the read-only permissions to your account.
 
-    After you select the **Embed** button, you can select the widget that you want to embed in your app.
-4. Select the type of widget that you want (**Cognitive Insights**, **Player**, or **Editor**).
+### Public content
+
+1. Sign in to the [Video Indexer](https://www.videoindexer.ai/) website.
+1. Select the video that you want to work with and press **Play**.
+1. Select the type of widget that you want (**Cognitive Insights**, **Player**, or **Editor**).
+1. Click **&lt;/&gt; Embed**.
 5. Copy the embed code (appears in **Copy the embedded code** in the **Share & Embed** dialog).
 6. Add the code to your app.
 
-> [!NOTE]
-> If you have issues sharing your video URLs, add the `location` parameter to the link. The parameter should be set to the [Azure regions in which Video Indexer exists](regions.md). For example: `https://www.videoindexer.ai/accounts/00000000-0000-0000-0000-000000000000/videos/b2b2c74b8e/?location=trial`.
-
-## Embedding private content
+### Private content
 
 To embed a private video, you must pass an access token in the `src` attribute of the iframe: