Dela via

Sök efter videor med API för videosökning i Bing

  • Artikel

Varning

Den 30 oktober 2020 flyttades Bing-sökning-API:erna 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.

Med API för videosökning i Bing är det enkelt att integrera Bings funktioner för kognitiv nyhetssökning i dina program. API:et hittar och returnerar i första hand relevanta videor på webben, men har även flera funktioner för intelligent och fokuserad videosökning på webben.

Hämta videor

För att hämta videor relaterade till användarens söktermer från webben skickar du följande GET-förfrågan:

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

Alla begäranden måste ske från en server.

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.

Om du vill hämta videor från en specifik domän använder du frågeoperatorn site:.

GET https://api.cognitive.microsoft.com/bing/v7.0/videos/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

Svaret innehåller ett Videos-svar som innehåller en lista med videor som Bing anser vara relevanta för frågan. Varje Video-objekt i listan innehåller videons webbadress, längd, storlek, kodningsformat och andra attribut. Videoobjektet innehåller även webbadressen till en miniatyrbild av videon och miniatyrbildens mått.

{
    "_type" : "Videos",
    "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=81EF7545...",
    "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=81EF7...",
            "thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=OVP.DYW...",
            "datePublished" : "2014-03-04T11:51:53",
            "publisher" : [
                {
                    "name" : "Fabrikam"
                }
            ],
            "creator" : 
            {
                "name" : "Marcus Appel"
            },
            "contentUrl" : "https:\/\/www.fabrikam.com\/watch?v=vzmPjZ--g",
            "hostPageUrl" : "https:\/\/www.bing.com\/cr?IG=81EF7545D569...",
            "encodingFormat" : "h264",
            "hostPageDisplayUrl" : "https:\/\/www.fabrikam.com\/watch?v=vzmPjZ--g",
            "width" : 1280,
            "height" : 720,
            "duration" : "PT2M47S",
            "motionThumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?id=OM.Y62...",
            "embedHtml" : "<iframe width=\"1280\" height=\"720\" src=\"https:...><\/iframe>",
            "allowHttpsEmbed" : true,
            "viewCount" : 8743,
            "thumbnail" : 
            {
                "width" : 300,
                "height" : 168
            },
            "videoId" : "6DB795E11A6E3CBAAD636DB795E113CBAAD63",
            "allowMobileEmbed" : true,
            "isSuperfresh" : false
        },
        ...
    ],
    "queryExpansions" : [...],
    "nextOffsetAddCount" : 0,
    "pivotSuggestions" : [...]
}

Videominiatyrer

Du kan visa alla eller en delmängd av videominiatyrerna som returneras av API för videosökning i Bing. Om du visar en delmängd bör du ge användaren möjlighet att visa återstående videor. som en del av användnings- och visningskraven för Bing API måste du visa videorna i den ordning som anges i svaret. Information om att ändra storlek på miniatyrbilden finns i Resizing and Cropping Thumbnails (Ändra storlek på och beskär miniatyrbilder).

När användaren för muspekaren över miniatyrbilden kan du använda motionThumbnailUrl till att spela upp en miniatyrversion av videon. Se till att du tillskriver ursprunget när du visar en video.

När du klickar på en miniatyrbild finns det tre alternativ för att visa videon:

  • Använd hostPageUrl till att visa videon på ursprungswebbplatsen (till exempel YouTube)
  • Använd webSearchUrl till att visa videon i Bing-spelaren
  • Använd embdedHtml till att bädda in videon i en egen upplevelse

Glöm inte att ange videons utgivare och upphovsman när du spelar upp den.

Mer information om hur du använder videoId till att få insikter om videon finns i Videoinsikter.

Filtrera videor

Som standard returnerar API för videosökning i Bing alla videor som är relevanta för frågan. Om du bara vill visa kostnadsfria videor eller klipp som är kortare än fem minuter skulle du använda följande filterparametrar i frågan:

  • pricing – Filtrera videor efter prissättning (till exempel videor som är kostnadsfria eller som du måste betala för)
  • resolution – Filtrera videor efter upplösning (till exempel videor med en upplösning på 720p eller högre)
  • videoLength – Filtrera videor efter videolängd (till exempel videor som är mindre än fem minuter långa)
  • färskhet – Filtrera videor efter ålder (till exempel videor som upptäckts av Bing under den senaste veckan)

Om du vill hämta videor från en specifik domän tar du med frågeoperatorn site: i frågesträngen.

Anteckning

Beroende på frågan finns det en risk när du använder frågeoperatorn site: att svaret har innehåll som är olämpligt för barn, oberoende av inställningen för safeSearch. Du bör endast använda site: om du är medveten om innehållet på webbplatsen och ditt scenario tillåter möjligheten att det förekommer innehåll som är olämpligt för barn.

I följande exempel visas hur du hämtar kostnadsfria videor från ContosoSailing.com med upplösningen 720p eller högre och som Bing har identifierat den senaste månaden.

GET https://api.cognitive.microsoft.com/bing/v7.0/videos/search?q=sailing+dinghies+site:contososailing.com&pricing=free&freshness=month&resolution=720p&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

Expandera frågan

Om Bing kan expandera frågan för att begränsa den ursprungliga sökningen innehåller objektet Videos fältet queryExpansions. Om frågan till exempel var Cleaning Gutters (rensa stuprännor) kan de expanderade frågorna vara Cleaning Gutters Tools (verktyg), Cleaning Gutters From the Ground (från marken), Gutter Gleaning Machine (maskin) och Easy Gutter Cleaning.

Här ser du de expanderade frågorna för Cleaning Gutters.

{
    "_type" : "Videos",
    "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=B52FBC5...",
    "totalEstimatedMatches" : 1000,
    "value" : [...],
    "nextOffsetAddCount" : 4,
    "queryExpansions" : [
        {
            "text" : "Gutter Cleaning Tools",
            "displayText" : "Tools",
            "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=B52FB....",
            "searchLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v5...",
            "thumbnail" : {
                "thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?q=Gutter..."
            }
        },
        ...
    ]
    "pivotSuggestions" : [...],
}

Fältet queryExpansions innehåller en lista över Query-objekt. Fältet text innehåller den expanderade frågan, och fältet displayText innehåller expansionstermen. Du kan använda text- och miniatyrfälten till att visa de expanderade frågesträngarna för användaren om en expanderad frågesträng är det användaren egentligen letar efter. Gör miniatyrbilden och texten klickbara genom att använda URL:en webSearchUrl eller URL:en searchLink. Använd webSearchUrl för att skicka användaren till Bing-sökresultat eller searchLink om du tillhandahåller din egen resultatsida.

Pivotera frågan

Om Bing kan segmentera den ursprungliga sökfrågan innehåller objektet Videos fältet pivotSuggestions. Om den ursprungliga frågan till exempel var Cleaning Gutters kan Bing segmentera frågan till Cleaning och Gutters.

Här är ett exempel på pivotförslagen för Cleaning Gutters.

{
    "_type" : "Videos",
    "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=B52FBC...",
    "totalEstimatedMatches" : 1000,
    "value" : [...],
    "nextOffsetAddCount" : 0,
    "queryExpansions" : [...],
    "pivotSuggestions" : [
        {
            "pivot" : "cleaning",
            "suggestions" : [
                {
                    "text" : "Gutter Repair",
                    "displayText" : "Repair",
                    "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=B52...",
                    "searchLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v5\/videos...",
                    "thumbnail" : {
                        "thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?q=Gutter..."
                    }
                },
                ...
            ]
        },
        {
            "pivot" : "gutters",
            "suggestions" : [
                {
                    "text" : "Window Cleaning",
                    "displayText" : "Window",
                    "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=B52FBC59...",
                    "searchLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v5...",
                    "thumbnail" : {
                        "thumbnailUrl" : "https:\/\/tse2.mm.bing.net\/th?q=Window..."
                    }
                },
                ...
            ]
        }
    ]
}

För varje pivot innehåller svaret en lista över Query-objekt som innehåller föreslagna frågor. Fältet text innehåller den föreslagna frågan, och fältet displayText innehåller den term som ersätter pivoten i den ursprungliga frågan. Till exempel Window Cleaning (fönsterputsning).

Du kan använda fälten text och thumbnail för att visa användaren de expanderade frågesträngarna om den expanderade frågesträngen är det användaren letar efter. Gör miniatyrbilden och texten klickbara genom att använda URL:en webSearchUrl eller URL:en searchLink. Använd webSearchUrl för att skicka användaren till Bing-sökresultat eller searchLink om du tillhandahåller din egen resultatsida.

Begränsningsbegäranden

Antalet frågor du kan ställa per sekund (QPS) beror på tjänsten och typen av prenumeration. Se till att programmet har den logik som behövs för att hålla dig inom kvoten. Om QPS-gränsen uppnås eller överskrids leder det till att begäran misslyckas och då returneras HTTP-statuskoden 429. Svaret innehåller Retry-After-huvudet, som anger hur länge du bör vänta innan du skickar en ny begäran.

Överbelastning eller begränsning?

Tjänsten skiljer på en överbelastningsattack (DoS) och en QPS-överträdelse. Om tjänsten misstänker en DoS-attack slutförs begäran (HTTP-statuskoden är 200 OK). Brödtexten i svaret är dock tom.