Obtenha informações sobre um vídeoGet insights about a video

Cada vídeo devolvido pela API de Pesquisa de Vídeo bing inclui um ID de vídeo que pode usar para obter mais informações sobre o mesmo, como vídeos relacionados.Each video returned by the Bing Video Search API includes a video ID that you can use to get more information about it, such as related videos. Para obter informações sobre um vídeo, obtenha o seu vídeoId token na resposta da API.To get insights about a video, get its videoId token in the API response.

    "value" : [
        {
            . . .
            "name" : "How to sail - What to Wear for Dinghy Sailing",
            "description" : "An informative video on what to wear...",
            "contentUrl" : "https:\/\/www.fabrikam.com\/watch?v=vzmPjHBZ--g",
            "videoId" : "6DB795E11A6E3CBAAD636DB795E11A6E3CBAAD63",
            . . .
        }
    ],

Em seguida, envie um pedido GET para os detalhes do vídeo final com o ID.Afterwards, send a GET request to the Video details endpoint with the ID. Defina o parâmetro de videoId consulta de identificação para o símbolo.Set the id query parameter to the videoId token. Para especificar as informações que pretende obter, defina o parâmetro de consulta dos módulos.To specify the insights that you want to get, set the modules query parameter. Para obter todas modules as ideias, tudo.To get all insights, set modules to All. A resposta inclui todas as informações que solicitou, se disponível.The response includes all the insights that you requested, if available.

GET https://api.cognitive.microsoft.com/bing/v7.0/videos/details?q=sailiing+dinghies&id=6DB795E11A6E3CBAAD636DB795E11A6E3CBAAD63&modules=All&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)  
X-MSEdge-ClientIP: 999.999.999.999  
X-Search-Location: lat:47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

Para obter vídeos relacionados com o vídeo especificado, defina RelatedVideoso parâmetro de consulta dos módulos para .To get videos that are related to the specified video, set the modules query parameter to RelatedVideos.

GET https://api.cognitive.microsoft.com/bing/v7.0/videos/details?q=sailiing+dinghies&id=6DB795E11A6E3CBAAD636DB795E11A6E3CBAAD63&modules=RelatedVideos&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)  
X-Search-ClientIP: 999.999.999.999  
X-Search-Location: lat:47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com  

A resposta a este pedido terá um objeto de vídeo de alto nível Em vez de um objeto de Vídeos.The response to this request will have a top-level VideoDetails object instead of a Videos object.

{
    "_type" : "Api.VideoDetails.VideoDetails",
    "relatedVideos" : {
        "value" : [
            {
                "name" : "How to sail - Reefing a Sail",
                "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=7284B07...",
                "thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?id=OVP.zt...",
                "datePublished" : "2014-03-04T16:11:09",
                "publisher" : [
                    {
                        "name" : "Fabrikam"
                    }
                ],
                "contentUrl" : "https:\/\/www.fabrikam.com\/watch?v=...",
                "hostPageUrl" : "https:\/\/www.bing.com\/cr?IG=7284B07...",
                "hostPageDisplayUrl" : "https:\/\/www.fabrikam.com\/watch?...",
                "duration" : "PT4M56S",
                "motionThumbnailUrl" : "https:\/\/tse1.mm.bing.net\/th?id=OM...",
                "allowHttpsEmbed" : true,
                "viewCount" : 21756,
                "videoId" : "AC1A157A4DDB571D03D6AC157A4DDB571D03D6",
                "allowMobileEmbed" : false,
                "isSuperfresh" : false
            },
            . . .
        ]
    }
}

Passos seguintesNext steps