Obtener información sobre un vídeo
Advertencia
El 30 de octubre de 2020, las API de Bing Search se trasladaron de los servicios de Azure AI a los servicios de Bing Search. Esta documentación se proporciona solo como referencia. Para obtener documentación actualizada, consulte la documentación de Bing Search API. Para obtener instrucciones sobre cómo crear nuevos recursos de Azure para Bing Search, consulte el artículo sobre la creación de un recurso de Bing Search a través de Azure Marketplace.
Cada vídeo que devuelve la API incluye un identificador de vídeo que puede usar para obtener más información sobre el vídeo, como, por ejemplo, vídeos relacionados. Para obtener información detallada sobre un vídeo, capture su token videoId en la respuesta de la API.
"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",
. . .
}
],
A continuación, envíe una solicitud GET al punto de conexión de detalles de vídeo con el identificador. Establezca el parámetro de consulta id en el token videoId. Para especificar la información que quiere obtener, establezca el parámetro de consulta modules. Para obtener todos los detalles, establezca modules en All (Todos). La respuesta incluye todas las conclusiones que ha solicitado, si están disponibles.
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
Obtención de información de vídeos relacionados
Para obtener vídeos relacionados con el vídeo especificado, establezca el parámetro de consulta modules en 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
La respuesta a esta solicitud tendrá un objeto VideoDetails de nivel superior en lugar de un objeto Videos.
{
"_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
},
. . .
]
}
}