Senden von Suchanforderungen an die Bing-Videosuche-APISending search requests to the Bing Video Search API

In diesem Artikel werden die Parameter und Attribute von Anforderungen beschrieben, die an die Bing-Videosuche-API gesendet werden. Außerdem finden Sie hier Informationen zum zurückgegebenen JSON-Antwortobjekt.This article describes the parameters and attributes of requests sent to the Bing Video Search API, as well as the JSON response object it returns.

Sie benötigen ein Cognitive Services-API-Konto mit Zugriff auf die Bing-Suche-APIs.You must have a Cognitive Services API account with access to the Bing Search APIs. Falls Sie nicht über ein Azure-Abonnement verfügen, können Sie ein kostenloses Konto erstellen.If you don't have an Azure subscription, you can create an account for free. Vor dem Fortfahren benötigen Sie den Zugriffsschlüssel, der nach dem Aktivieren Ihrer kostenlosen Testversion bereitgestellt wird. Alternativ hierzu können Sie auch den Schlüssel eines kostenpflichtigen Abonnements aus Ihrem Azure-Dashboard verwenden.Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.

Vorschlagen von Suchbegriffen mit der Bing-Vorschlagssuche-APISuggest search terms with the Bing Autosuggest API

Wenn Sie ein Suchfeld bereitstellen, in das Benutzer ihre Suchbegriffe eingeben, verwenden Sie die Bing-Vorschlagssuche-API, um die Benutzerfreundlichkeit zu verbessern.If you provide a search box where the user enters their search term, use the Bing Autosuggest API to improve the experience. Die API gibt vorgeschlagene Abfragezeichenfolgen zurück, während der Benutzer einen Suchbegriff eingibt.The API returns suggested query strings based on partial search terms as the user types.

Codieren Sie den vom Benutzer eingegebenen Suchbegriff als URL, bevor Sie den Abfrageparameter q festlegen.After the user enters their search term, URL-encode it before setting the q query parameter. Wenn der Benutzer also beispielsweise sailing dinghies eingibt, legen Sie q auf sailing+dinghies oder sailing%20dinghies fest.For example, if the user enters sailing dinghies, set q to sailing+dinghies or sailing%20dinghies.

Senden einer AnforderungSending a request

Um Videosuchergebnisse zu erhalten, senden Sie eine GET-Anforderung an den folgenden Endpunkt:To get Video search results, you'd send a GET request to the following endpoint:

https://api.cognitive.microsoft.com/bing/v7.0/videos/search

Die Anforderung muss das HTTPS-Protokoll verwenden.The request must use the HTTPS protocol.

Alle Anforderungen sollten von einem Server stammen.We recommend that all requests originate from a server. Das Verteilen eines Schlüssels als Teil einer Clientanwendung bietet mehr Gelegenheiten, dass eine böswillige dritte Partei darauf zugreift.Distributing the key as part of a client application provides more opportunity for a malicious third party to access it. Aufrufe von einem Server stellen zudem einen einzelnen Upgradepunkt für zukünftige Versionen der API dar.Making calls from a server also provides a single upgrade point for future versions of the API.

Die Anforderung muss den Abfrageparameter q angeben, der den Suchbegriff des Benutzers enthält.The request must specify the q query parameter, which contains the user's search term. Obwohl er optional ist, sollte die Anforderung auch den Abfrageparameter mkt angeben, wodurch der Markt identifiziert wird, von dem die Ergebnisse stammen sollen.Although it's optional, the request should also specify the mkt query parameter, which identifies the market where you want the results to come from. Unter Abfrageparameter finden Sie eine Liste optionaler Abfrageparameter wie pricing.For a list of optional query parameters such as pricing, see Query Parameters. Alle Abfrageparameterwerte müssen URL-codiert sein.All query parameter values must be URL encoded.

Die Anforderung muss den Ocp-Apim-Subscription-Key-Header angeben.The request must specify the Ocp-Apim-Subscription-Key header. Auch wenn dies optional ist, sollten Sie die folgenden Header ebenfalls angeben:Although optional, you are encouraged to also specify the following headers:

Die Client-IP- und Adressheader sind für die Rückgabe von standortorientiertem Inhalt wichtig.The client IP and location headers are important for returning location aware content.

Eine Liste aller Anforderungs- und Antwortheader finden Sie unter Header.For a list of all request and response headers, see Headers.

Beispiel für eine SuchanforderungExample search request

Im Folgenden ist eine Suchanforderung dargestellt, die alle vorgeschlagenen Abfrageparameter und -header enthält.The following shows a search request that includes all the suggested query parameters and headers. Wenn Sie zuvor noch keine der Bing-APIs aufgerufen haben, lassen Sie den Client-ID-Header weg.If it's your first time calling any of the Bing APIs, don't include the client ID header. Schließen Sie die Client-ID nur ein, wenn Sie bereits eine Bing-API aufgerufen haben und Bing eine Client-ID für die Kombination aus Benutzer und Gerät zurückgegeben hat.Only include the client ID if you've previously called a Bing API and Bing returned a client ID for the user and device combination.

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  

JSON-BeispielantwortExample JSON response

Das folgende Beispiel zeigt die Antwort auf die vorherige Anforderung.The following shows the response to the previous request. Im Beispiel sind auch die Bing-spezifischen Antwortheader aufgeführt.The example also shows the Bing-specific response headers.

Hinweis

Da sich URL-Formate und -Parameter ohne Vorankündigung ändern können, verwenden Sie alle URLs in der vorliegenden Form.Because URL formats and parameters are subject to change without notice, use all URLs as-is. Es sollten keine Abhängigkeiten von URL-Format oder -Parametern bestehen, außer wenn dies angegeben ist.You should not take dependencies on the URL format or parameters except where noted.

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ächste SchritteNext steps

Testen Sie die API.Try out the API. Besuchen Sie die Testkonsole für die Videosuche-API.Go to Video Search API Testing Console.

Ausführliche Informationen zur Nutzung der Antwortobjekte finden Sie unter Suchen nach Videos im Web.For details about consuming the response objects, see Searching the Web for Videos.

Details zum Abrufen von Auswertungen zu einem Video, z.B. verwandte Suchvorgänge, finden Sie unter Videoauswertungen.For details about getting insights about a video such as related searches, see Video Insights.

Weitere Informationen über Videos, die in sozialen Medien beliebt sind, finden Sie unter Beliebte Videos.For details about videos that are trending on social media, see Trending Videos.