Abrufen beliebter Videos mit der Bing-Videosuche-API
Warnung
Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.
Die Bing-Videosuche-API ermöglicht es Ihnen, die aktuellen Trendvideos aus dem gesamten Web und in verschiedenen Kategorien zu finden.
GET-Anforderung
Um mit der Bing-Videosuche-API die aktuellen Trendvideos abzurufen, senden Sie die folgenden GET-Anforderung:
GET https://api.cognitive.microsoft.com/bing/v7.0/videos/trending?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
Marktunterstützung
Die folgenden Märkte unterstützen beliebte Videos.
- en-AU (Englisch, Australien)
- en-CA (Englisch, Kanada)
- En-GB (Englisch, Großbritannien)
- en-ID (Englisch, Indonesien)
- en-IE (Englisch, Irland)
- en-IN (Englisch, Indien)
- en-NZ (Englisch, Neuseeland)
- en-PH (Englisch, Philippinen)
- en-SG (Englisch, Singapur)
- en-US (Englisch, USA)
- en-WW (English, weltweit aggregierter Code)
- en-ZA (Englisch, Südafrika)
- zh-CN (Chinesisch, China)
JSON-Beispielantwort
Das folgende Beispiel zeigt eine API-Antwort, die Trendvideos enthält, die nach Kategorie und Unterkategorie aufgelistet sind. Die Antwort enthält auch Bannervideos, das heißt, die beliebtesten Videos, die aus einer oder mehreren Kategorien stammen können.
{
"_type" : "TrendingVideos",
"bannerTiles" : [
{
"query" : {
"text" : "Hello - Smith",
"displayText" : "Hello - Smith",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3E8F5..."
},
"image" : {
"description" : "Image from: contosowallpapers.com",
"thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=RsA%2fdPlTmx4zS...",
"headLine" : "\"Hello\" is a song by...",
"contentUrl" : "http:\/\/www.contosowallpapers.com\/wp-content..."
}
},
. . .
],
"categories" : [
{
"title" : "Music videos",
"subcategories" : [
{
"tiles" : [
{
"query" : {
"text" : "Song Title - Artist Name",
"displayText" : "Song Title - Artist Name",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3E8F5..."
},
"image" : {
"description" : "Image from: contoso.com",
"thumbnailUrl" : "https:\/\/tse2.mm.bing.net\/th?id=...",
"contentUrl" : "http:\/\/images6.contoso.com\/image..."
}
},
. . .
],
"title" : "Top "
},
{
"tiles" : [...],
"title" : "Trending"
},
. . .
],
},
{
"title" : "Viral videos",
"subcategories" : [
{
"tiles" : [...],
"title" : "Trending"
},
. . .
],
},
. . .
]
}