A Bing Search API-k eredményeinek lapozása

  • Cikk

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 hívást küld a Bing Web, Egyéni, Kép, Hírek vagy Videókeresés API-knak, a Bing a lekérdezés szempontjából releváns találatok teljes számának egy részét adja vissza. Az elérhető eredmények becsült teljes számának lekéréséhez lépjen a válaszobjektum mezőjéhez totalEstimatedMatches .

Például:

{
    "_type" : "SearchResponse",
    "webPages" : {
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA...",
        "totalEstimatedMatches" : 262000,
        "value" : [...]
    }
}

Lapozás a keresési eredmények között

Az elérhető eredmények lapozásához használja a és offset a count lekérdezési paramétereket a kérés elküldésekor.

Megjegyzés

  • A Bing Video, Image és News API-k lapozása csak az általános videókeresésekre (), hírekre (/video/search/news/search) és képekre (/image/search) vonatkozik. A népszerű témakörök és kategóriák lapozása nem támogatott.
  • A TotalEstimatedMatches mező az aktuális lekérdezés keresési eredményeinek teljes számát becsüli meg. A és offset paraméterek beállításakor ez a count becslés változhat.
Paraméter Leírás
count Megadja a válaszban visszaadandó eredmények számát. Vegye figyelembe, hogy az alapértelmezett érték és counta kért eredmények maximális száma API-tól függően változik. Ezeket az értékeket a referenciadokumentációban találja a Következő lépések szakaszban.
offset A kihagyandó eredmények számát adja meg. A offset nulla alapú, és kisebbnek kell lennie, mint ( - totalEstimatedMatchescount).

Ha például oldalanként 15 találatot szeretne megjeleníteni, a 15-ös és offset a 0-s értékre kell állítania count az első találati oldal lekéréséhez. Minden további API-hívás esetében 15-zel növekszik offset . Az alábbi példa 15 weblapot kér a 45. eltolástól kezdődően.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&count=15&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

Ha az alapértelmezett count értéket használja, csak a lekérdezési paramétert kell megadnia az offset API-hívásokban.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

A Bing Image és a Video API-k használatakor az érték használatával elkerülheti az nextOffset ismétlődő keresési eredményeket. Kérje le az értéket a vagy Videos válaszobjektumokbólImages, és használja a kérésekben a offset paraméterrel.

Megjegyzés

A Bing Web Search API olyan keresési eredményeket ad vissza, amelyek tartalmazhatnak weblapokat, képeket, videókat és híreket. Amikor a Bing Web Search API keresési eredményeit lapoz, csak a WebPages lapokat lapozhatja, nem pedig más választípusokat, például képeket vagy híreket. Az objektumok keresési WebPage eredményei tartalmazhatnak más választípusokban is megjelenő találatokat.

Ha a lekérdezési paramétert responseFilter szűrőértékek megadása nélkül használja, ne használja a és offset a count paramétereket.

Következő lépések