Filtern der Ergebnisse, die die Suchantwort enthältFiltering the answers that the search response includes

Wenn Sie das Web abfragen, gibt Bing alle Inhalte zurück, die für die Suche relevant sind.When you query the web, Bing returns all the relevant content it finds for the search. Wenn die Suchabfrage z.B. „sailing+dinghies“ lautet, kann die Antwort die folgenden Ergebnisse enthalten:For example, if the search query is "sailing+dinghies", the response might contain the following answers:

{
    "_type" : "SearchResponse",
    "webPages" : {
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43C...",
        "totalEstimatedMatches" : 262000,
        "value" : [...]
    },
    "images" : {
        "id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",
        "readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA5CA6464E5D...",
        "isFamilyFriendly" : true,
        "value" : [...]
    },
    "rankingResponse" : {
        "mainline" : {
            "items" : [...]
        }
    }
}    

AbfrageparameterQuery parameters

Zum Filtern der von Bing zurückgegebenen Antworten verwenden Sie die folgenden Parameter beim Aufrufen der API.To filter the answers returned by Bing, use the below query parameters when calling the API.

ResponseFilterResponseFilter

Sie können die Antworttypen, die von Bing einbezogen werden (z.B. Bilder, Videos und News), mit dem Abfrageparameter responseFilter filtern. Hierbei handelt es sich um eine durch Trennzeichen getrennte Liste von Antworten.You can filter the types of answers that Bing includes in the response (for example images, videos, and news) by using the responseFilter query parameter, which is a comma-delimited list of answers. Eine Antwort wird aufgenommen, wenn Bing relevante Inhalte dafür findet.An answer will be included in the response if Bing finds relevant content for it.

Um bestimmte Antworten auszuschließen (z.B. Bilder), stellen Sie dem Antworttyp das Zeichen - voran.To exclude specific answers from the response such as images, prepend a - character to the answer type. Beispiel:For example:

&responseFilter=-images,-videos

Im folgenden wird gezeigt, wie responseFilter zum Anfordern von Bildern, Videos und News zu Segeljollen verwendet wird.The following shows how to use responseFilter to request images, videos, and news of sailing dinghies. Wenn Sie die Abfragezeichenfolge codieren, ändern sich die Trennzeichen in %2C.When you encode the query string, the commas change to %2C.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&responseFilter=images%2Cvideos%2Cnews&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:  47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com  

Das folgende Beispiel zeigt die Antwort auf die vorherige Abfrage.The following shows the response to the previous query. Da Bing keine relevanten Video- und Newsergebnisse gefunden hat, enthält die Antwort diese auch nicht.Because Bing didn't find relevant video and news results, the response doesn't include them.

{
    "_type" : "SearchResponse",
    "images" : {
        "id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",
        "readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3AD78B183C56456C...",
        "isFamilyFriendly" : true,
        "value" : [...]
    },
    "rankingResponse" : {
        "mainline" : {
            "items" : [{
                "answerType" : "Images",
                "value" : {
                    "id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images"
                }
            }]
        }
    }
}

Obwohl Bing in der vorherigen Antwort keine Video- und News-Ergebnisse zurückgegeben hat, bedeutet dies nicht, dass es keine Video- und News-Inhalte gibt.Although Bing did not return video and news results in the previous response, it does not mean that video and news content does not exist. Es bedeutet lediglich, dass sie nicht auf der Seite enthalten waren.It simply means that the page didn't include them. Wenn Sie jedoch weitere Seiten mit Ergebnissen anzeigen, werden die nachfolgenden Seiten solche Ergebnisse wahrscheinlich enthalten.However, if you page through more results, the subsequent pages would likely include them. Auch wenn Sie die Videosuche-API- und News-Suche-API-Endpunkte direkt aufrufen, enthält die Antwort wahrscheinlich Ergebnisse.Also, if you call the Video Search API and News Search API endpoints directly, the response would likely contain results.

Es wird davon abgeraten, responseFilter zu verwenden, um Ergebnisse von einer einzigen API zu erhalten.You are discouraged from using responseFilter to get results from a single API. Wenn Sie Inhalte von einer einzelnen Bing-API wünschen, rufen Sie diese API direkt auf.If you want content from a single Bing API, call that API directly. Um beispielsweise nur Bilder zu erhalten, senden Sie eine Anforderung an den Bildersuche-API-Endpunkt, an https://api.cognitive.microsoft.com/bing/v7.0/images/search oder einen der anderen Bilder-Endpunkte.For example, to receive only images, send a request to the Image Search API endpoint, https://api.cognitive.microsoft.com/bing/v7.0/images/search or one of the other Images endpoints. Der Aufruf der einzelnen API ist nicht nur aus Leistungsgründen wichtig, sondern auch, weil die inhaltsspezifischen APIs reichhaltigere Ergebnisse liefern.Calling the single API is important not only for performance reasons but because the content-specific APIs offer richer results. Sie können z.B. Filter zum Filtern der Ergebnisse verwenden, die für die Web-API nicht verfügbar sind.For example, you can use filters that are not available to the Web Search API to filter the results.

WebsiteSite

Um Suchergebnisse von einer bestimmten Domäne zu erhalten, schließen Sie den Abfrageparameter site: in die Abfragezeichenfolge ein.To get search results from a specific domain, include the site: query parameter in the query string.

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

Hinweis

Bei Verwendung des Abfrageoperators site: kann es je nach Abfrage vorkommen, dass die Antwort ggf nicht jugendfreie Inhalte enthält (unabhängig von der Einstellung safeSearch).Depending on the query, if you use the site: query operator, there is the chance that the response may contain adult content regardless of the safeSearch setting. Verwenden Sie site: nur, wenn Sie wissen, welche Inhalte die Website enthält, und wenn in Ihrem Szenario ggf. auch nicht jugendfreie Inhalte zulässig sind.You should use site: only if you are aware of the content on the site and your scenario supports the possibility of adult content.

AktualitätFreshness

Um die Antwortergebnisse aus dem Web auf Webseiten einzuschränken, die Bing während eines bestimmten Zeitraums ermittelt hat, setzen Sie den Abfrageparameter freshness auf einen der folgenden Werte (ohne Beachtung von Groß-/Kleinschreibung):To limit the web answer results to webpages that Bing discovered during a specific period, set the freshness query parameter to one of the following case-insensitive values:

  • Day: Gibt Webseiten zurück, die Bing innerhalb der letzten 24 Stunden ermittelt hat.Day — Return webpages that Bing discovered within the last 24 hours
  • Week: Gibt Webseiten zurück, die Bing innerhalb der letzten 7 Tage ermittelt hat.Week — Return webpages that Bing discovered within the last 7 days
  • Month: Gibt Webseiten zurück, die Bing innerhalb der letzten 30 Tage ermittelt hat.Month — Return webpages that discovered within the last 30 days

Sie können diesen Parameter auch auf einen benutzerdefinierten Datumsbereich in der Form YYYY-MM-DD..YYYY-MM-DD festlegen.You may also set this parameter to a custom date range in the form, YYYY-MM-DD..YYYY-MM-DD.

https://<host>/bing/v7.0/search?q=ipad+updates&freshness=2019-02-01..2019-05-30

Um die Ergebnisse auf ein einzelnes Datum zu beschränken, legen Sie den Parameter „freshness“ auf ein bestimmtes Datum fest:To limit the results to a single date, set the freshness parameter to a specific date:

https://<host>/bing/v7.0/search?q=ipad+updates&freshness=2019-02-04

Die Ergebnisse enthalten möglicherweise Webseiten, die außerhalb des angegebenen Zeitraums liegen, wenn die Anzahl der Webseiten, die Bing mit Ihren Filterkriterien abgleicht, kleiner ist als die Anzahl von Webseiten, die Sie angefordert haben (oder die Standardanzahl, die von Bing zurückgegeben wird).The results may include webpages that fall outside the specified period if the number of webpages that Bing matches to your filter criteria is less than the number of webpages you requested (or the default number that Bing returns).

Einschränken der Anzahl von Ergebnissen in der AntwortLimiting the number of answers in the response

Bing kann mehrere Antworttypen in der JSON-Antwort zurückgeben.Bing can return multiple answer types in the JSON response. Wenn Sie z.B. sailing+dinghies abfragen, gibt Bing möglicherweise webpages, images, videos und relatedSearches zurück.For example, if you query sailing+dinghies, Bing might return webpages, images, videos, and relatedSearches.

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailing dinghies"
    },
    "webPages" : {...},
    "images" : {...},
    "relatedSearches" : {...},
    "videos" : {...},
    "rankingResponse" : {...}
}

Um die Anzahl der Antworten einzuschränken, die Bing an die beiden wichtigsten Ergebnisse (Webseiten und Bilder) zurückgibt, legen Sie den Abfrageparameter answerCount auf 2 fest.To limit the number of answers that Bing returns to the top two answers (webpages and images), set the answerCount query parameter to 2.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&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:  47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com  

Die Antwort enthält nur webPages und images.The response includes only webPages and images.

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailing dinghies"
    },
    "webPages" : {...},
    "images" : {...},
    "rankingResponse" : {...}
}

Wenn Sie den Abfrageparameter responseFilter zur vorherigen Abfrage hinzufügen und ihn auf Webseiten und News festlegen, enthält die Antwort nur Webseiten, da News keine Rangfolge haben.If you add the responseFilter query parameter to the previous query and set it to webpages and news, the response contains only webpages because news is not ranked.

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailing dinghies"
    },
    "webPages" : {...},
    "rankingResponse" : {...}
}

Höherstufen von Antworten, die keine Rangfolge besitzenPromoting answers that are not ranked

Wenn die am besten bewerteten Antworten, die Bing für eine Abfrage zurückgibt, Webseiten, Bilder, Videos und relatedSearches sind, würde die Antwort diese Ergebnisse enthalten.If the top ranked answers that Bing returns for a query are webpages, images, videos, and relatedSearches, the response would include those answers. Wenn Sie answerCount auf 2 festlegen, gibt Bing die beiden Ergebnisse mit der höchsten Rangfolge zurück: Webseiten und Bilder.If you set answerCount to two (2), Bing returns the top two ranked answers: webpages and images. Wenn Bing Bilder und Videos in die Antwort einbeziehen soll, geben Sie den Abfrageparameter promote an und legen ihn auf Bilder und Videos fest.If you want Bing to include images and videos in the response, specify the promote query parameter and set it to images and videos.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&promote=images%2Cvideos&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:  47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com  

Das folgende Beispiel zeigt die Antwort auf die Anforderung oben.The following is the response to the above request. Bing gibt die am besten bewerteten zwei Antworten (Webseiten und Bilder) zurück und stuft Videos höher, sodass diese in die Antwort aufgenommen werden.Bing returns the top two answers, webpages and images, and promotes videos into the answer.

{
    "_type" : "SearchResponse",
    "queryContext" : {
        "originalQuery" : "sailiing dinghies"
    },
    "webPages" : {...},
    "images" : {...},
    "videos" : {...},
    "rankingResponse" : {...}
}

Wenn Sie promote auf News festlegen, enthält die Antwort kein News-Ergebnis, da dies keine Antwort mit Rangfolge ist — Sie können nur Antworten mit Rangfolge höher stufen.If you set promote to news, the response doesn't include the news answer because it is not a ranked answer—you can promote only ranked answers.

Die Antworten, die Sie höher stufen möchten, zählen nicht für den answerCount-Grenzwert.The answers that you want to promote do not count against the answerCount limit. Wenn die Antworten mit Rangfolge z.B. News, Bilder und Videos sind, und legen Sie answerCount auf 1 und promote auf News fest, enthält die Antwort News und Bilder.For example, if the ranked answers are news, images, and videos, and you set answerCount to 1 and promote to news, the response contains news and images. Wenn die Antworten mit Rangfolge Videos, Bilder und News sind, enthält die Antwort Videos und News.Or, if the ranked answers are videos, images, and news, the response contains videos and news.

Sie können promote nur verwenden, wenn Sie den Abfrageparameter answerCount angeben.You may use promote only if you specify the answerCount query parameter.