Inzicht krijgen in een video
Waarschuwing
Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing-documentatie voor zoeken-API voor bijgewerkte documentatie. Zie Een Zoeken in Bing-resource maken via de Azure Marketplace voor instructies over het maken van nieuwe Azure-resources voor Bing Search.
Elke video die wordt geretourneerd door de Bing Video's zoeken-API bevat een video-id die u kunt gebruiken om er meer informatie over te krijgen, zoals gerelateerde video's. Als u inzicht wilt krijgen in een video, haalt u het bijbehorende videoId-token op in het API-antwoord.
"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",
. . .
}
],
Verzend daarna een GET-aanvraag naar het eindpunt met videogegevens met de id. Stel de queryparameter id in op het videoId token. Als u de inzichten wilt opgeven die u wilt ophalen, stelt u de queryparameter van de modules in . Als u alle inzichten wilt ophalen, stelt u in modules op Alles. Het antwoord bevat alle inzichten die u hebt aangevraagd, indien beschikbaar.
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
Inzichten in gerelateerde video's verkrijgen
Als u video's wilt ophalen die betrekking hebben op de opgegeven video, stelt u de queryparameter van de modules in op 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
Het antwoord op deze aanvraag heeft een VideoDetails-object op het hoogste niveau in plaats van een Video-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
},
. . .
]
}
}