Merge pull request #101053 from Juliako/patch-167

Update upload-index-videos.md

Author: megvanhuygen

articles/media-services/video-indexer/toc.yml

@@ -45,7 +45,7 @@
     href: connect-to-azure.md
   - name: Manage account connected to Azure
     href: manage-account-connected-to-azure.md
-  - name: Use API to upload and index videos
+  - name: Upload and index videos
     href: upload-index-videos.md
   - name: Examine Video Indexer output
     href: video-indexer-output-json-v2.md

articles/media-services/video-indexer/upload-index-videos.md

@@ -9,7 +9,7 @@ manager: femila
 ms.service: media-services
 ms.subservice: video-indexer
 ms.topic: article
-ms.date: 01/14/2020
+ms.date: 01/13/2020
 ms.author: juliako
 ---
 
@@ -21,9 +21,12 @@ When uploading videos with Video Indexer API, you have the following upload opti
 * send the video file as a byte array in the request body,
 * Use existing Azure Media Services asset by providing the [asset ID](https://docs.microsoft.com/azure/media-services/latest/assets-concept) (supported in paid accounts only).
 
-The article shows how to use the [Upload video](https://api-portal.videoindexer.ai/docs/services/operations/operations/Upload-video?) API to upload and index your videos based on a URL. The code sample in the article includes the commented out code that shows how to upload the byte array. <br/>The article also discusses some of the parameters that you can set on the API to change the process and output of the API.
+Once your video has been uploaded, Video Indexer (optionally) encodes the video (discussed in the article). When creating a Video Indexer account, you can choose a free trial account (where you get a certain number of free indexing minutes) or a paid option (where you are not limited by the quota). With free trial, Video Indexer provides up to 600 minutes of free indexing to website users and up to 2400 minutes of free indexing to API users. With paid option, you create a Video Indexer account that is [connected to your Azure subscription and an Azure Media Services account](connect-to-azure.md). You pay for minutes indexed as well as the Media Account related charges. 
 
-Once your video has been uploaded, Video Indexer, optionally encodes the video (discussed in the article). When creating a Video Indexer account, you can choose a free trial account (where you get a certain number of free indexing minutes) or a paid option (where you are not limited by the quota). With free trial, Video Indexer provides up to 600 minutes of free indexing to website users and up to 2400 minutes of free indexing to API users. With paid option, you create a Video Indexer account that is [connected to your Azure subscription and an Azure Media Services account](connect-to-azure.md). You pay for minutes indexed as well as the Media Account related charges. 
+The article shows how to upload and index your videos with these options:
+
+* [The Video Indexer website](#website) 
+* [The Video Indexer APIs](#apis)
 
 ## Uploading considerations and limitations
 
@@ -36,22 +39,50 @@ Once your video has been uploaded, Video Indexer, optionally encodes the video (
 - The URL provided in the `videoURL` param needs to be encoded.
 - Indexing Media Services assets has the same limitation as indexing from URL.
 - Video Indexer has a max duration limit of 4 hours for a single file.
+- The URL needs to be accessible (for example a public URL). 
+
+    If it is a private URL, the access token need to be provided in the request.
+- The URL has to point to a valid media file and not to a webpage, such as a link to `www.youtube.com` page.
 - You can upload up to 60 movies per minute.
 
 > [!Tip]
 > It is recommended to use .NET framework version 4.6.2. or higher because older .NET frameworks do not default to TLS 1.2.
 >
 > If you must use older .NET frameworks, add one line into your code before making the REST API call:  <br/> System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls | SecurityProtocolType.Tls11 | SecurityProtocolType.Tls12;
 
-## Configurations and params
+## Supported file formats for Video Indexer
+
+See the [input container/file formats](../latest/media-encoder-standard-formats.md#input-containerfile-formats) article for a list of file formats that you can use with Video Indexer.
+
+## <a id="website"/>Upload and index a video using the Video Indexer website
+
+> [!NOTE]
+> A name of the video must be no greater than 80 characters.
+
+1. Sign in on the [Video Indexer](https://www.videoindexer.ai/) website.
+2. To upload a video, press the **Upload** button or link.
+
+    ![Upload](./media/video-indexer-get-started/video-indexer-upload.png)
+
+    Once your video has been uploaded, Video Indexer starts indexing and analyzing the video.
+
+    ![Uploaded](./media/video-indexer-get-started/video-indexer-uploaded.png) 
+
+    Once Video Indexer is done analyzing, you will get a notification with a link to your video and a short description of what was found in your video. For example: people, topics, OCRs.
+
+## <a id="apis"/>Upload and index with API
+
+Use the [Upload video](https://api-portal.videoindexer.ai/docs/services/operations/operations/Upload-video?) API to upload and index your videos based on a URL. The code sample that follows includes the commented out code that shows how to upload the byte array. 
+
+### Configurations and params
 
 This section describes some of the optional parameters and when you would want to set them.
 
-### externalID 
+#### externalID 
 
 This parameter enables you to specify an ID that will be associated with the video. The ID can be applied to external "Video Content Management" (VCM) system integration. The videos that are located in the Video Indexer portal can be searched using the specified external ID.
 
-### callbackUrl
+#### callbackUrl
 
 A URL that is used to notify the customer (using a POST request) about the following events:
 
@@ -75,12 +106,12 @@ A URL that is used to notify the customer (using a POST request) about the follo
         
     - Example: https:\//test.com/notifyme?projectName=MyProject&id=1234abcd&faceid=12&knownPersonId=CCA84350-89B7-4262-861C-3CAC796542A5&personName=Inigo_Montoya 
 
-#### Notes
+##### Notes
 
 - Video Indexer returns any existing parameters provided in the original URL.
 - The provided URL must be encoded.
 
-### indexingPreset
+#### indexingPreset
 
 Use this parameter if raw or external recordings contain background noise. This parameter is used to configure the indexing process. You can specify the following values:
 
@@ -91,13 +122,13 @@ Use this parameter if raw or external recordings contain background noise. This
 
 Price depends on the selected indexing option.  
 
-### priority
+#### priority
 
 Videos are indexed by Video Indexer according to their priority. Use the **priority** parameter to specify the index priority. The following values are valid: **Low**, **Normal** (default), and **High**.
 
 **Priority** parameter is only supported for paid accounts.
 
-### streamingPreset
+#### streamingPreset
 
 Once your video has been uploaded, Video Indexer, optionally encodes the video. Then, proceeds to indexing, and analyzing the video. When Video Indexer is done analyzing, you will get a notification with the video ID.  
 
@@ -107,17 +138,17 @@ In order to run the indexing and encoding jobs, the [Azure Media Services accoun
 
 If you only want to index your video but not encode it, set `streamingPreset`to `NoStreaming`.
 
-### videoUrl
+#### videoUrl
 
 A URL of the video/audio file to be indexed. The URL must point at a media file (HTML pages are not supported). The file can be protected by an access token provided as part of the URI and the endpoint serving the file must be secured with TLS 1.2 or higher. The URL needs to be encoded. 
 
 If the `videoUrl` is not specified, the Video Indexer expects you to pass the file as a multipart/form body content.
 
-## Code sample
+### Code sample
 
 The following C# code snippet demonstrates the usage of all the Video Indexer APIs together.
 
-### Instructions for running this code sample
+#### Instructions for running this code sample
 
 After copying this code into your development platform you will need to provide two parameters: API Management authentication key and video URL.
 
@@ -304,7 +335,8 @@ public class AccountContractSlim
     public string AccessToken { get; set; }
 }
 ```
-## Common errors
+
+### Common errors
 
 The status codes listed in the following table may be returned by the Upload operation.