Partilhar via


Obter vídeos populares com a API de Pesquisa de Vídeos do Bing

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

A API de Pesquisa de Vídeos do Bing permite-lhe encontrar os vídeos mais populares atuais a partir da Web e em categorias diferentes.

Pedido GET

Para obter os vídeos populares atuais a partir da API de Pesquisa de Vídeos do Bing, envie o seguinte pedido GET:

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  

Suporte ao mercado

Os mercados seguintes suportam vídeos populares.

  • en-AU (Inglês, Austrália)
  • en-CA (Inglês, Canadá)
  • en-GB (Inglês, Grã-Bretanha)
  • en-ID (Inglês, Indonésia)
  • en-IE (Inglês, Irlanda)
  • en-IN (Inglês, Índia)
  • en-NZ (Inglês, Nova Zelândia)
  • en-PH (Inglês, Filipinas)
  • en-SG (Inglês, Singapura)
  • en-US (inglês, Estados Unidos)
  • en-WW (inglês, código de agregação mundial)
  • en-ZA (Inglês, África do Sul)
  • zh-CN (chinês, China)

Resposta JSON de exemplo

O exemplo seguinte mostra uma resposta de API que contém vídeos populares, que são listados por categoria e subcategoria. A resposta também contém vídeos de faixa, que são os vídeos mais populares e podem ser provenientes de uma ou mais categorias.

{  
    "_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"
                },
                . . .
            ],  
        },
        . . .  
    ]  
}  
  

Passos seguintes