A keresési válasz által tartalmazott válaszok szűrése

Cikk
07/08/2019

Figyelmeztetés

2020. október 30-án a Bing Search API-k átkerültek az Azure AI-szolgáltatásokból a Bing Search Servicesbe. Ez a dokumentáció csak referenciaként szolgál. A frissített dokumentációt a Bing search API dokumentációjában találja. Az új Azure-erőforrások Bing-kereséshez való létrehozásával kapcsolatos útmutatásért lásd: Bing Search-erőforrás létrehozása a Azure Marketplace keresztül.

Amikor lekérdezi az internetet, a Bing visszaadja a kereséshez talált összes releváns tartalmat. Ha például a keresési lekérdezés "sailing+dinghies", a válasz a következő válaszokat tartalmazhatja:

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

Lekérdezési paraméterek

A Bing által visszaadott válaszok szűréséhez használja az alábbi lekérdezési paramétereket az API meghívásakor.

ResponseFilter

A válaszban szereplő válaszok típusait (például képeket, videókat és híreket) a válaszSzűrő lekérdezés paraméterrel szűrheti, amely a válaszok vesszővel tagolt listája. A válasz akkor jelenik meg, ha a Bing releváns tartalmat talál a válaszban.

Ha konkrét válaszokat szeretne kizárni a válaszból, például képeket, írjon be egy karaktert - a választípusra. Például:

&responseFilter=-images,-videos

Az alábbiakban azt mutatjuk be, hogyan kérhet responseFilter képeket, videókat és híreket a vitorlázási dinghiesről. A lekérdezési sztring kódolásakor a vesszők %2C értékre változnak.

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

Az alábbiakban az előző lekérdezésre adott válasz látható. Mivel a Bing nem talált releváns videó- és híreredményeket, a válasz nem tartalmazza őket.

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

Bár a Bing nem adott vissza video- és híreredményeket az előző válaszban, ez nem jelenti azt, hogy a videó- és hírtartalmak nem léteznek. Ez egyszerűen azt jelenti, hogy az oldal nem tartalmazza őket. Ha azonban több eredményt ad meg, a következő oldalak valószínűleg tartalmazzák őket. Ha a Video Search API-t és a News Search API-végpontokat közvetlenül hívja meg, a válasz valószínűleg tartalmaz eredményeket.

Nem ajánlott responseFilter egyetlen API-ból származó eredményeket lekérni. Ha egyetlen Bing API-ból szeretne tartalmat kapni, hívja meg közvetlenül az API-t. Ha például csak képeket szeretne fogadni, küldjön egy kérést a Image Search API-végpontra vagy https://api.cognitive.microsoft.com/bing/v7.0/images/search a többi Képvégpont egyikére. Az egyetlen API meghívása nem csak teljesítménybeli okokból fontos, hanem azért is, mert a tartalomspecifikus API-k gazdagabb eredményeket kínálnak. Használhat például olyan szűrőket, amelyek nem érhetők el a Web Search API-hoz az eredmények szűréséhez.

Hely

Ha egy adott tartomány keresési eredményeit szeretné lekérni, adja meg a site: lekérdezési paramétert a lekérdezési sztringben.

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

Megjegyzés

A lekérdezéstől függően, ha a lekérdezési operátort site: használja, előfordulhat, hogy a válasz felnőtt tartalmat tartalmaz a safeSearch beállítástól függetlenül. Csak akkor használja a site: operátort, ha ismeri a webhely tartalmát, és a felnőtteknek szóló tartalmak megjelenítése nem okoz problémát.

Frissesség

Ha a webes válaszeredményeket a Bing által egy adott időszakban felderített weblapokra szeretné korlátozni, állítsa a frissesség-lekérdezés paraméterét az alábbi kis- és nagybetűkre érzéketlen értékek egyikére:

Day — Visszaadja azokat a weblapokat, amelyeket a Bing az elmúlt 24 órában észlelt
Week — A Bing által az elmúlt 7 napban felderített weblapok visszaadása
Month — Az elmúlt 30 napban felderített weblapok visszaküldése

Ezt a paramétert egyéni dátumtartományra is beállíthatja az űrlapon. YYYY-MM-DD..YYYY-MM-DD

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

Ha az eredményeket egyetlen dátumra szeretné korlátozni, állítsa a frissesség paramétert egy adott dátumra:

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

Az eredmények tartalmazhatnak olyan weblapokat is, amelyek a megadott időszakon kívül esnek, ha a Bing által a szűrési feltételeknek megfelelő weblapok száma kisebb, mint a kért weblapok száma (vagy a Bing által visszaadott alapértelmezett szám).

A válaszok számának korlátozása a válaszban

A Bing több választípust is visszaadhat a JSON-válaszban. Ha például a sailing+dinghies lekérdezést kérdezi le, a Bing a , images, videosés relatedSearchesa értéket is visszaadhatjawebpages.

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

A Bing által a két legjobb válaszra (weblapokra és képekre) visszaküldött válaszok számának korlátozásához állítsa az answerCount lekérdezési paramétert 2-es értékre.

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

A válasz csak webPages a és imagesa elemet tartalmazza.

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

Ha hozzáadja a responseFilter lekérdezési paramétert az előző lekérdezéshez, és weblapokra és hírekre állítja, a válasz csak weblapokat tartalmaz, mert a hírek nincsenek rangsorolva.

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

Nem rangsorolt válaszok népszerűsítése

Ha a Bing által a lekérdezésekhez visszaadott elsőrangú válaszok weblapok, képek, videók és kapcsolódóSearches, a válasz tartalmazza ezeket a válaszokat. Ha az answerCount értéket két (2) értékre állítja, a Bing a két első rangsorolt választ adja vissza: weblapokat és képeket. Ha azt szeretné, hogy a Bing képeket és videókat tartalmazzon a válaszban, adja meg az előléptetési lekérdezés paramétert, és állítsa be képekre és videókra.

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

A következő a fenti kérésre adott válasz. A Bing visszaadja a két legjobb választ, weblapokat és képeket, és a videókat a válaszba reklámozza.

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

Ha hírekre állítja promote be a választ, a válasz nem tartalmazza a hírválaszt, mert nem rangsorolt válasz – csak a rangsorolt válaszokat előléptetheti.

Az előléptetni kívánt válaszok nem számítanak bele a korlátba answerCount . Ha például a rangsorolt válaszok hírek, képek és videók, és az 1 és promote a hírek értékre vannak állítvaanswerCount, a válasz híreket és képeket tartalmaz. Vagy ha a rangsorolt válaszok videók, képek és hírek, a válasz videókból és hírekből áll.

Csak akkor használhatja promote , ha megadja a lekérdezési paramétert answerCount .

Megosztás a következőn keresztül: