Skicka sökbegäranden till API:et för videosökning i Bing
Varning
Den 30 oktober 2020 flyttade Bing-sökning API:er från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.
I den här artikeln beskrivs parametrarna och attributen för begäranden som skickas till API:et för videosökning i Bing samt det JSON-svarsobjekt som det returnerar.
Skapa en Azure-resurs
Börja använda API:et för videosökning i Bing genom att skapa någon av följande Azure-resurser:
- Tillgänglig via Azure Portal tills du tar bort resursen.
- Använd den kostnadsfria prisnivån för att prova tjänsten och uppgradera senare till en betald nivå för produktion.
- Tillgänglig via Azure Portal tills du tar bort resursen.
- Använd samma nyckel och slutpunkt för dina program i flera Azure AI-tjänster.
Föreslå söktermer med API:t Automatiska förslag i Bing
Om du tillhandahåller en sökruta där användaren anger sin sökterm bör du använda API för automatiska förslag i Bing för att ge bättre funktioner. API:t returnerar föreslagna frågesträngar baserat på partiella söktermer som användaren skriver in.
När användaren har angett sin sökterm URL-kodar du den innan du anger frågeparametern q. Om användaren till exempel anger segeljollar ställer du in q till sailing+dinghies eller sailing%20dinghies.
Skicka en begäran
För att få resultat från en videosökning skickar du en GET-begäran till följande slutpunkt:
https://api.cognitive.microsoft.com/bing/v7.0/videos/search
Begäran måste använda HTTPS-protokollet.
Vi rekommenderar att alla förfrågningar kommer från en server. Om nyckeln distribueras som en del av ett klientprogram ökar risken för att en illvillig tredje part kan komma åt den. Anrop från en server innebär dessutom att det bara finns en enda uppgraderingspunkt för framtida versioner av API:et.
Begäran måste innehålla frågeparametern q, som innehåller användarens sökterm. Även om det är valfritt bör begäran även innehålla frågeparametern mkt, som identifierar marknaden som du vill att resultatet ska komma från. En lista över valfria frågeparametrar som pricing finns i Frågeparametrar. Alla frågeparametervärden måste vara URL-kodade.
Begäran måste innehålla huvudet Ocp-Apim-Subscription-Key. Även om det är valfritt rekommenderar vi även att följande huvuden finns med:
Sidhuvuden för klientens IP-adress och platsen är viktiga för att returnera platsmedvetet innehåll.
En lista över alla sidhuvuden för begäranden och svar finns i Sidhuvuden.
Exempel på sökbegäran
Nedan visas en sökbegäran som innehåller alla föreslagna frågeparametrar och sidhuvuden. Om det är den första gången du anropar ett Bing-API inkluderar du inte klientens ID-huvud. Inkludera endast klient-ID om du har anropat ett Bing-API förut och om Bing returnerade ett klient-ID för användar- och enhetskombinationen.
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
Exempel på JSON-svar
Nedan visas svaret på den tidigare begäran. Exemplet visar också Bing-specifika svarshuvuden.
Anteckning
Eftersom URL-format och parametrar kan komma att ändras utan föregående meddelande använder du alla URL:er som de är. Du bör inte använda beroenden för URL-formatet eller parametrarna, förutom där det anges.
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..."
}
},
. . .
]
}
]
}
Nästa steg
Testa API:et. Gå till testningskonsolen för videosöknings-API:et.
Mer information om hur du använder svarsobjekten finns i Searching the Web for Videos (Söka efter videor på webben).
Mer information om hur du får insikter om en video, till exempel relaterade sökningar, finns i Video Insights (Videoinsikter).
Mer information om videor som är populära i sociala medier finns i Populära videor.