De antwoorden filteren die het zoekantwoord bevat

Artikel
07/08/2019

Waarschuwing

Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing zoek-API-documentatie voor bijgewerkte documentatie. Zie Een Zoeken in Bing resource maken via de Azure Marketplace voor instructies voor het maken van nieuwe Azure-resources voor Bing Search.

Wanneer u een query uitvoert op het web, retourneert Bing alle relevante inhoud die voor de zoekopdracht wordt gevonden. Als de zoekquery bijvoorbeeld 'sailing+dinghies' is, kan het antwoord de volgende antwoorden bevatten:

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

Queryparameters

Als u de antwoorden wilt filteren die door Bing worden geretourneerd, gebruikt u de onderstaande queryparameters bij het aanroepen van de API.

ResponseFilter

U kunt de typen antwoorden filteren die Bing in het antwoord opneemt (bijvoorbeeld afbeeldingen, video's en nieuws) met behulp van de queryparameter responseFilter , een door komma's gescheiden lijst met antwoorden. Een antwoord wordt opgenomen in het antwoord als Bing relevante inhoud voor het antwoord vindt.

Als u specifieke antwoorden wilt uitsluiten van het antwoord, zoals afbeeldingen, moet u een - teken toevoegen aan het antwoordtype. Bijvoorbeeld:

&responseFilter=-images,-videos

Hieronder ziet u hoe responseFilter u afbeeldingen, video's en nieuws over zeilboten kunt aanvragen. Wanneer u de queryreeks coderen, worden de komma's gewijzigd 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

Hieronder ziet u de respons op de vorige query. Omdat Bing geen relevante video- en nieuwsresultaten heeft gevonden, bevat het antwoord deze niet.

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

Hoewel Bing in het vorige antwoord geen video- en nieuwsresultaten heeft geretourneerd, betekent dit niet dat video- en nieuwsinhoud niet bestaat. Het betekent gewoon dat de pagina deze niet bevat. Als u echter door meer resultaten bladert, bevatten de volgende pagina's deze waarschijnlijk. Als u de eindpunten van de Video's zoeken-API en Nieuws zoeken-API rechtstreeks aanroept, bevat het antwoord waarschijnlijk resultaten.

U wordt afgeraden om te gebruiken responseFilter om resultaten van één API op te halen. Als u inhoud van één Bing-API wilt, roept u die API rechtstreeks aan. Als u bijvoorbeeld alleen afbeeldingen wilt ontvangen, verzendt u een aanvraag naar het eindpunt https://api.cognitive.microsoft.com/bing/v7.0/images/search van de Afbeeldingen zoeken-API of naar een van de andere eindpunten voor afbeeldingen . Het aanroepen van de enkele API is niet alleen belangrijk om prestatieredenen, maar omdat de inhoudsspecifieke API's uitgebreidere resultaten bieden. U kunt bijvoorbeeld filters gebruiken die niet beschikbaar zijn voor de Webzoekopdrachten-API om de resultaten te filteren.

Site

Als u zoekresultaten wilt ophalen uit een specifiek domein, neemt u de site: queryparameter op in de querytekenreeks.

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

Notitie

Afhankelijk van de query, als u de site: queryoperator gebruikt, bestaat de kans dat het antwoord inhoud voor volwassenen bevat, ongeacht de instelling safeSearch . Gebruik site: alleen als u zich bewust bent van de inhoud op de site en uw scenario de mogelijkheid van inhoud voor volwassenen ondersteunt.

Nieuwheid

Als u de resultaten van webantwoorden wilt beperken tot webpagina's die Bing tijdens een bepaalde periode heeft gedetecteerd, stelt u de queryparameter voor nieuwheid in op een van de volgende niet-hoofdlettergevoelige waarden:

Day — Webpagina's retourneren die Bing in de afgelopen 24 uur heeft gedetecteerd
Week — Webpagina's retourneren die Bing in de afgelopen 7 dagen heeft gedetecteerd
Month — Webpagina's retourneren die in de afgelopen 30 dagen zijn gedetecteerd

U kunt deze parameter ook instellen op een aangepast datumbereik in de vorm , YYYY-MM-DD..YYYY-MM-DD.

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

Als u de resultaten tot één datum wilt beperken, stelt u de versheidsparameter in op een specifieke datum:

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

De resultaten kunnen webpagina's bevatten die buiten de opgegeven periode vallen als het aantal webpagina's dat Bing aan uw filtercriteria voldoet kleiner is dan het aantal webpagina's dat u hebt aangevraagd (of het standaardnummer dat Bing retourneert).

Het aantal antwoorden in het antwoord beperken

Bing kan meerdere antwoordtypen retourneren in het JSON-antwoord. Als u bijvoorbeeld een query uitvoert op sailing+dinghies, kan Bing , images, videosen relatedSearchesretournerenwebpages.

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

Stel de queryparameter answerCount in op 2 om het aantal antwoorden dat Bing retourneert te beperken tot de twee belangrijkste antwoorden (webpagina's en afbeeldingen).

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

Het antwoord bevat alleen webPages en images.

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

Als u de responseFilter queryparameter toevoegt aan de vorige query en deze instelt op webpagina's en nieuws, bevat het antwoord alleen webpagina's omdat nieuws niet is geclassificeerd.

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

Het promoten van antwoorden die niet zijn gerangschikt

Als de belangrijkste antwoorden die Bing retourneert voor een query webpagina's, afbeeldingen, video's en relatedSearches zijn, bevat het antwoord deze antwoorden. Als u answerCount instelt op twee (2), retourneert Bing de twee meest gerangschikte antwoorden: webpagina's en afbeeldingen. Als u wilt dat Bing afbeeldingen en video's in het antwoord opneemt, geeft u de queryparameter niveau verhogen op en stelt u deze in op afbeeldingen en video's.

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

Hier volgt het antwoord op de bovenstaande aanvraag. Bing retourneert de twee belangrijkste antwoorden, webpagina's en afbeeldingen, en promoveert video's tot het antwoord.

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

Als u op nieuws instelt promote , bevat het antwoord niet het antwoord op nieuws, omdat het geen gerangschikt antwoord is. U kunt alleen gerangschikte antwoorden promoveren.

De antwoorden die u wilt promoveren, tellen niet mee voor de answerCount limiet. Als de gerangschikte antwoorden bijvoorbeeld nieuws, afbeeldingen en video's zijn en u instelt answerCount op 1 en promote op nieuws, bevat het antwoord nieuws en afbeeldingen. Of, als de gerangschikte antwoorden video's, afbeeldingen en nieuws zijn, bevat het antwoord video's en nieuws.

U mag alleen gebruiken promote als u de answerCount queryparameter opgeeft.