Invio di richieste di ricerca all'API Ricerca video Bing
Avvertimento
Il 30 ottobre 2020, le API di ricerca Bing sono state spostate dai servizi di intelligenza artificiale di Azure ai servizi di ricerca Bing. Questa documentazione è disponibile solo per riferimento. Per la documentazione aggiornata, vedere la Documentazione dell'API di Ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per Ricerca Bing, vedere Creare una risorsa di Ricerca Bing tramite Azure Marketplace.
Questo articolo descrive i parametri e gli attributi delle richieste inviate all'API Ricerca video Bing, nonché l'oggetto risposta JSON restituito.
Creare una risorsa di Azure
Iniziare a usare l'API Ricerca video Bing creando una delle risorse di Azure seguenti:
- Disponibile tramite il portale di Azure fino a quando non si elimina la risorsa.
- Usare il piano tariffario gratuito per provare il servizio e eseguire l'aggiornamento in un secondo momento a un livello a pagamento per la produzione.
- Disponibile tramite il portale di Azure fino a quando non si elimina la risorsa.
- Usare la stessa chiave e lo stesso endpoint per le applicazioni in più servizi di intelligenza artificiale di Azure.
Suggerire termini di ricerca con l'API Suggerimenti automatici Bing
Se si specifica una casella di ricerca in cui l'utente immette il termine di ricerca, usare l'API Suggerimenti automatici Bing per migliorare l'esperienza. L'API restituisce stringhe di query suggerite in base a termini di ricerca parziali come tipi di utente.
Dopo che l'utente immette il termine di ricerca, codificarlo in URL prima di impostare il parametro di query q. Ad esempio, se l'utente immette dinghi a vela, impostare q su sailing+dinghies o sailing%20dinghies.
Invio di una richiesta
Per ottenere i risultati della ricerca video, inviare una richiesta GET all'endpoint seguente:
https://api.cognitive.microsoft.com/bing/v7.0/videos/search
La richiesta deve usare il protocollo HTTPS.
È consigliabile che tutte le richieste provengano da un server. La distribuzione della chiave come parte di un'applicazione client consente a terze parti dannose di accedervi. L'esecuzione di chiamate da un server fornisce anche un singolo punto di aggiornamento per le versioni future dell'API.
La richiesta deve specificare il parametro di query q che contiene il termine di ricerca dell'utente. Anche se è facoltativo, la richiesta deve anche specificare il parametro di query mkt, che identifica il mercato da cui si desidera ottenere i risultati. Per un elenco di parametri di query facoltativi, ad esempio pricing, vedere i Parametri di Query in . Tutti i valori dei parametri di query devono essere codificati in URL.
La richiesta deve specificare l'intestazione Ocp-Apim-Subscription-Key. Anche se è facoltativo, è comunque consigliabile specificare le seguenti intestazioni:
- User-Agent
- X-MSEdge-ClientID
- X-Search-ClientIP
- X-Search-Location
Le intestazioni IP e posizione del client sono importanti per la fornitura di contenuto sensibile alla posizione.
Per un elenco di tutte le intestazioni di richiesta e risposta, vedere Intestazioni.
Richiesta di ricerca di esempio
Di seguito viene illustrata una richiesta di ricerca che include tutti i parametri di query e le intestazioni suggeriti. Se è la prima volta che si chiama una delle API Bing, non includere l'intestazione dell'ID client. Includere l'ID client solo se in precedenza è stata chiamata un'API Bing e Bing ha restituito un ID client per la combinazione utente e dispositivo.
GET https://api.cognitive.microsoft.com/bing/v7.0/videos/search?q=sailing+dinghies&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
Esempio di risposta JSON
Di seguito viene illustrata la risposta alla richiesta precedente. L'esempio mostra anche le intestazioni di risposta specifiche per Bing.
Nota
Poiché i formati e i parametri degli URL sono soggetti a modifiche senza preavviso, usare tutti gli URL as-is. Non è consigliabile accettare dipendenze dal formato o dai parametri dell'URL, tranne dove indicato.
BingAPIs-TraceId: 76DD2C2549B94F9FB55B4BD6FEB6AC
X-MSEdge-ClientID: 1C3352B306E669780D58D607B96869
BingAPIs-Market: en-US
{
"_type" : "Videos",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=81EF7545D5694...",
"totalEstimatedMatches" : 1000,
"value" : [
{
"name" : "How to sail - What to Wear for Dinghy Sailing",
"description" : "An informative video on what to wear when...",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=81EF7545D56...",
"thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=OVP.DYWCvh...",
"datePublished" : "2014-03-04T11:51:53",
"publisher" : [
{
"name" : "Fabrikam"
}
],
"creator" : {
"name" : "Marcus Appel"
},
"contentUrl" : "https:\/\/www.fabrikam.com\/watch?v=vzmPjHZ--g",
"hostPageUrl" : "https:\/\/www.bing.com\/cr?IG=81EF7545D56944...",
"encodingFormat" : "h264",
"hostPageDisplayUrl" : "https:\/\/www.fabrikam.com\/watch?v=vzmPjBZ--g",
"width" : 1280,
"height" : 720,
"duration" : "PT2M47S",
"motionThumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?id=OM.Y6...",
"embedHtml" : "<iframe width=\"1280\" height=\"720\" src=\"https:...><\/iframe>",
"allowHttpsEmbed" : true,
"viewCount" : 8743,
"thumbnail" : {
"width" : 300,
"height" : 168
},
"videoId" : "6DB795E11A6E3CBAAD636DB795E11E3CBAAD63",
"allowMobileEmbed" : true,
"isSuperfresh" : false
},
. . .
],
"nextOffset" : 0,
"pivotSuggestions" : [
{
"pivot" : "sailing",
"suggestions" : []
},
{
"pivot" : "dinghies",
"suggestions" : [
{
"text" : "Sailing Cruising",
"displayText" : "Cruising",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=81EF754...",
"searchLink" : "https:\/\/api.cognitive.microsoft.com...",
"thumbnail" : {
"thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?q=Sailing..."
}
},
. . .
]
}
]
}
Passaggi successivi
Provare l'API. Vai a Console di test dell'API Ricerca video.
Per informazioni dettagliate su come utilizzare gli oggetti di risposta, vedere Ricerca di video sul Web.
Per informazioni dettagliate su come ottenere informazioni dettagliate su un video, ad esempio le ricerche correlate, vedere Video Insights.
Per informazioni dettagliate sui video di tendenza sui social media, vedi Video di tendenza.