Filtern der Ergebnisse, die die Suchantwort enthält

Artikel
07/08/2019

Warnung

Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.

Wenn Sie das Web abfragen, gibt Bing alle Inhalte zurück, die für die Suche relevant sind. Wenn die Suchabfrage z.B. „sailing+dinghies“ lautet, kann die Antwort die folgenden Ergebnisse enthalten:

{
    "_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" : [...]
        }
    }
}

Abfrageparameter

Zum Filtern der von Bing zurückgegebenen Antworten verwenden Sie die folgenden Parameter beim Aufrufen der API.

ResponseFilter

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. Eine Antwort wird aufgenommen, wenn Bing relevante Inhalte dafür findet.

Um bestimmte Antworten auszuschließen (z.B. Bilder), stellen Sie dem Antworttyp das Zeichen - voran. Beispiel:

&responseFilter=-images,-videos

Im folgenden wird gezeigt, wie responseFilter zum Anfordern von Bildern, Videos und News zu Segeljollen verwendet wird. Wenn Sie die Abfragezeichenfolge codieren, ändern sich die Trennzeichen in %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. Da Bing keine relevanten Video- und Newsergebnisse gefunden hat, enthält die Antwort diese auch nicht.

{
    "_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. Es bedeutet lediglich, dass sie nicht auf der Seite enthalten waren. Wenn Sie jedoch weitere Seiten mit Ergebnissen anzeigen, werden die nachfolgenden Seiten solche Ergebnisse wahrscheinlich enthalten. Auch wenn Sie die Videosuche-API- und News-Suche-API-Endpunkte direkt aufrufen, enthält die Antwort wahrscheinlich Ergebnisse.

Es wird davon abgeraten, responseFilter zu verwenden, um Ergebnisse von einer einzigen API zu erhalten. Wenn Sie Inhalte von einer einzelnen Bing-API wünschen, rufen Sie diese API direkt auf. 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. Der Aufruf der einzelnen API ist nicht nur aus Leistungsgründen wichtig, sondern auch, weil die inhaltsspezifischen APIs reichhaltigere Ergebnisse liefern. Sie können z.B. Filter zum Filtern der Ergebnisse verwenden, die für die Web-API nicht verfügbar sind.

Website

Um Suchergebnisse von einer bestimmten Domäne zu erhalten, schließen Sie den Abfrageparameter site: in die Abfragezeichenfolge ein.

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). 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.

Aktualität

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):

Day: Gibt Webseiten zurück, die Bing innerhalb der letzten 24 Stunden ermittelt hat.
Week: Gibt Webseiten zurück, die Bing innerhalb der letzten 7 Tage ermittelt hat.
Month: Gibt Webseiten zurück, die Bing innerhalb der letzten 30 Tage ermittelt hat.

Sie können diesen Parameter auch auf einen benutzerdefinierten Datumsbereich in der Form YYYY-MM-DD..YYYY-MM-DD festlegen.

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:

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).

Einschränken der Anzahl von Ergebnissen in der Antwort

Bing kann mehrere Antworttypen in der JSON-Antwort zurückgeben. Wenn Sie z.B. sailing+dinghies abfragen, gibt Bing möglicherweise webpages, images, videos und relatedSearches zurück.

{
    "_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.

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.

{
    "_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.

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

Höherstufen von Antworten, die keine Rangfolge besitzen

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. Wenn Sie answerCount auf 2 festlegen, gibt Bing die beiden Ergebnisse mit der höchsten Rangfolge zurück: Webseiten und Bilder. Wenn Bing Bilder und Videos in die Antwort einbeziehen soll, geben Sie den Abfrageparameter promote an und legen ihn auf Bilder und Videos fest.

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. 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.

{
    "_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.

Die Antworten, die Sie höher stufen möchten, zählen nicht für den answerCount-Grenzwert. 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. Wenn die Antworten mit Rangfolge Videos, Bilder und News sind, enthält die Antwort Videos und News.

Sie können promote nur verwenden, wenn Sie den Abfrageparameter answerCount angeben.