Sdílet prostřednictvím

Postup procházení výsledků z rozhraní API Vyhledávání Bingu

  • Článek

Upozornění

30. října 2020 se rozhraní API Vyhledávání Bingu přesunula ze služeb Azure AI na Vyhledávání Bingu Services. Tato dokumentace je k dispozici pouze pro referenci. Aktualizovanou dokumentaci najdete v dokumentaci k rozhraní API bingu pro vyhledávání. Pokyny k vytváření nových prostředků Azure pro vyhledávání Bingem najdete v tématu Vytvoření prostředku Vyhledávání Bingu prostřednictvím Azure Marketplace.

Když odešlete volání do webových rozhraní API Bingu, Vlastních, Obrázků, Zpráv nebo Vyhledávání videí, vrátí Bing podmnožinu celkového počtu výsledků, které můžou být pro dotaz relevantní. Pokud chcete získat odhadovaný celkový počet dostupných výsledků, přejděte k poli objektu totalEstimatedMatches odpovědi.

Příklad:

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

Stránkování výsledků hledání

Pokud chcete procházet dostupné výsledky, použijte count při odesílání požadavku parametry a offset dotazu.

Poznámka

  • Stránkování pomocí rozhraní API pro video, obrázky a zprávy Bingu se vztahuje pouze na obecné vyhledávání videí (/video/search), zpráv (/news/search) a obrázků (/image/search). Stránkování mezi populárními tématy a kategoriemi není podporováno.
  • Pole TotalEstimatedMatches je odhad celkového počtu výsledků hledání aktuálního dotazu. Když nastavíte count parametry a offset , může se tento odhad změnit.
Parametr Popis
count Určuje počet výsledků, které se mají vrátit v odpovědi. Všimněte si, že výchozí hodnota counta maximální počet výsledků, které můžete požadovat, se liší podle rozhraní API. Tyto hodnoty najdete v referenční dokumentaci v části Další kroky.
offset Určuje počet výsledků, které se mají přeskočit. Hodnota offset je založená na nule a měla by být menší než ( - totalEstimatedMatchescount).

Pokud například chcete zobrazit 15 výsledků na stránce, nastavíte count hodnotu 15 a offset 0, abyste získali první stránku výsledků. Pro každé další volání rozhraní API byste se zvýšili offset o 15. Následující příklad vyžaduje 15 webových stránek začínajících od posunu 45.

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

Pokud použijete výchozí count hodnotu, stačí zadat offset pouze parametr dotazu ve voláních rozhraní API.

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

Pokud používáte rozhraní API Bingu pro obrázky a video, můžete tuto hodnotu použít nextOffset , abyste se vyhnuli duplicitním výsledkům hledání. Získejte hodnotu z Images objektů odpovědi nebo Videos a použijte ji v požadavcích pomocí parametru offset .

Poznámka

Rozhraní API Bingu pro vyhledávání na webu vrací výsledky hledání, které můžou zahrnovat webové stránky, obrázky, videa a zprávy. Když procházíte výsledky hledání z rozhraní API Bingu pro vyhledávání na webu, stránkujete jenom webové stránky a ne jiné typy odpovědí, jako jsou obrázky nebo zprávy. Výsledky hledání v WebPage objektech můžou obsahovat také výsledky, které se zobrazují v jiných typech odpovědí.

Pokud použijete responseFilter parametr dotazu bez zadání hodnot filtru, nepoužívejte count parametry a offset .

Další kroky