Filtrování odpovědí, které vyhledávací odpověď obsahuje

Článek
07/08/2019

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ž se dotazujete na web, bing vrátí veškerý relevantní obsah, který najde pro hledání. Pokud je například vyhledávací dotaz "sailing+dinghies", odpověď může obsahovat následující odpovědi:

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

Parametry dotazů

Pokud chcete filtrovat odpovědi vrácené Bingem, použijte při volání rozhraní API následující parametry dotazu.

Filtr odpovědi

Typy odpovědí, které Bing zahrne do odpovědi (například obrázky, videa a zprávy), můžete filtrovat pomocí parametru dotazu responseFilter , což je seznam odpovědí oddělených čárkami. Odpověď bude zahrnuta v odpovědi, pokud Bing najde relevantní obsah.

Pokud chcete z odpovědi vyloučit konkrétní odpovědi, jako jsou obrázky, napište - na typ odpovědi znak. Příklad:

&responseFilter=-images,-videos

Následující informace ukazují, jak použít responseFilter k vyžádání obrázků, videí a zpráv o plachetních člunech. Při kódování řetězce dotazu se čárky změní na %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

Následující příklad ukazuje odpověď na předchozí dotaz. Vzhledem k tomu, že Bing nenašel relevantní výsledky videa a zpráv, odpověď je nezahrnuje.

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

Přestože Bing nevrátil výsledky videa a zpráv v předchozí odpovědi, neznamená to, že video a obsah zpráv neexistuje. Jednoduše to znamená, že je stránka nezahrnovala. Pokud ale projdete více výsledků, budou je pravděpodobně obsahovat následující stránky. Pokud také zavoláte rozhraní API pro vyhledávání videí a koncové body rozhraní API pro vyhledávání zpráv přímo, bude odpověď pravděpodobně obsahovat výsledky.

Nedoporučujeme vám používat responseFilter k získání výsledků z jednoho rozhraní API. Pokud chcete obsah z jednoho rozhraní API Bingu, zavolejte ho přímo. Pokud například chcete přijímat jenom obrázky, odešlete požadavek do koncového bodu https://api.cognitive.microsoft.com/bing/v7.0/images/search rozhraní API pro vyhledávání obrázků nebo do některého z dalších koncových bodů Images . Volání jednoho rozhraní API je důležité nejen z důvodu výkonu, ale také proto, že rozhraní API specifická pro obsah nabízejí bohatší výsledky. K filtrování výsledků můžete použít například filtry, které nejsou dostupné pro rozhraní API vyhledávání na webu.

Web

Pokud chcete získat výsledky hledání z konkrétní domény, zahrňte site: do řetězce dotazu parametr dotazu.

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

Poznámka

V závislosti na dotazu, pokud použijete site: operátor dotazu, existuje možnost, že odpověď může obsahovat obsah pro dospělé bez ohledu na nastavení bezpečného hledání . Operátor site: byste měli používat, pouze pokud znáte obsah příslušného webu a váš scénář podporuje možnost zobrazení obsahu pro dospělé.

Aktuálnost

Pokud chcete omezit výsledky webových odpovědí na webové stránky, které Bing zjistil během určitého období, nastavte parametr dotazu aktuálnosti na jednu z následujících hodnot nerozlišující malá a malá písmena:

Day — Vrácení webových stránek, které Bing zjistil během posledních 24 hodin
Week — Vrácení webových stránek, které Bing zjistil během posledních 7 dnů
Month — Vrátit webové stránky zjištěné během posledních 30 dnů

Tento parametr můžete také nastavit na vlastní rozsah dat ve formuláři YYYY-MM-DD..YYYY-MM-DD.

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

Pokud chcete omezit výsledky na jedno datum, nastavte parametr aktuálnosti na konkrétní datum:

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

Výsledky můžou zahrnovat webové stránky, které spadají mimo zadané období, pokud je počet webových stránek, které Bing odpovídá kritériím filtru, menší než počet požadovaných webových stránek (nebo výchozí číslo, které Bing vrátí).

Omezení počtu odpovědí v odpovědi

Bing může v odpovědi JSON vrátit několik typů odpovědí. Pokud například zadáte dotaz sailing+dinghies, Bing může vrátit webpages, images, videosa relatedSearches.

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

Pokud chcete omezit počet odpovědí, které Bing vrací na dvě první odpovědi (webové stránky a obrázky), nastavte parametr dotazu answerCount na hodnotu 2.

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

Odpověď obsahuje pouze webPages a images.

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

Pokud přidáte responseFilter parametr dotazu do předchozího dotazu a nastavíte ho na webové stránky a zprávy, odpověď bude obsahovat jenom webové stránky, protože zprávy nejsou seřazené.

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

Zvýšení úrovně odpovědí, které nejsou seřazené

Pokud jsou nejčastějšími odpověďmi, které Bing vrátí pro dotaz, webové stránky, obrázky, videa a související hledání, bude odpověď tyto odpovědi zahrnovat. Pokud nastavíte answerCount na dvě (2), vrátí Bing dvě první seřazené odpovědi: webové stránky a obrázky. Pokud chcete, aby Bing do odpovědi zahrnul obrázky a videa, zadejte parametr dotazu pro zvýšení úrovně a nastavte ho na obrázky a videa.

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

Následuje odpověď na výše uvedený požadavek. Bing vrátí dvě první odpovědi, webové stránky a obrázky, a propaguje videa do odpovědi.

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

Pokud nastavíte promote na novinky, odpověď neobsahuje odpověď na zprávy, protože se nejedná o seřazenou odpověď – můžete propagovat jenom seřazené odpovědi.

Odpovědi, které chcete zvýšit, se do limitu nezapočítávají answerCount . Pokud jsou například seřazené odpovědi zprávy, obrázky a videa a vy nastavíte answerCount hodnotu 1 a promote zprávy, bude odpověď obsahovat zprávy a obrázky. Nebo pokud jsou seřazené odpovědi videa, obrázky a zprávy, odpověď obsahuje videa a zprávy.

Můžete použít promote pouze v případě, že zadáte answerCount parametr dotazu.