Dela via

Filtrera svaren som söksvaret innehåller

  • Artikel

Varning

Den 30 oktober 2020 flyttades Bing-sökning-API:erna från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.

När du frågar på webben returnerar Bing allt relevant innehåll som hittas för sökningen. Om sökfrågan till exempel är "sailing+dinghies" kan svaret innehålla följande svar:

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

Frågeparametrar

Om du vill filtrera svaren som returneras av Bing använder du frågeparametrarna nedan när du anropar API:et.

ResponseFilter

Du kan filtrera de typer av svar som Bing innehåller i svaret (till exempel bilder, videor och nyheter) med hjälp av frågeparametern responseFilter , som är en kommaavgränsad lista med svar. Ett svar tas med i svaret om Bing hittar relevant innehåll för det.

Om du vill undanta specifika svar från svaret, till exempel bilder, lägger du till ett - tecken till svarstypen. Exempel:

&responseFilter=-images,-videos

Följande visar hur du använder responseFilter för att begära bilder, videor och nyheter om seglings jollar. När du kodar frågesträngen ändras kommatecknet till %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

Nedan visas svaret på den tidigare frågan. Eftersom Bing inte hittade relevanta video- och nyhetsresultat inkluderar svaret inte dem.

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

Även om Bing inte returnerade video- och nyhetsresultat i föregående svar betyder det inte att video- och nyhetsinnehåll inte finns. Det innebär helt enkelt att sidan inte innehöll dem. Men om du bläddrar igenom fler resultat skulle de efterföljande sidorna sannolikt innehålla dem. Om du anropar API:et för videosökning och API-slutpunkterna för nyhetssökning direkt skulle svaret sannolikt innehålla resultat.

Du rekommenderas inte att använda responseFilter för att hämta resultat från ett enda API. Om du vill ha innehåll från ett enda Bing-API anropar du det API:et direkt. Om du till exempel bara vill ta emot bilder skickar du en begäran till API-slutpunkten https://api.cognitive.microsoft.com/bing/v7.0/images/search för bildsökning eller någon av de andra slutpunkterna för bilder . Det är viktigt att anropa det enskilda API:et, inte bara av prestandaskäl, utan även för att innehållsspecifika API:er ger bättre resultat. Du kan till exempel använda filter som inte är tillgängliga för API:et för webbsökning för att filtrera resultaten.

Webbplats

Om du vill hämta sökresultat från en specifik domän inkluderar du site: frågeparametern i frågesträngen.

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

Anteckning

Om du använder site: frågeoperatorn kan svaret innehålla vuxet innehåll oavsett safeSearch-inställningen , beroende på frågan. Du bör endast använda site: om du är medveten om innehållet på webbplatsen och ditt scenario tillåter möjligheten att det förekommer innehåll som är olämpligt för barn.

Aktualitet

Om du vill begränsa webbsvarsresultaten till webbsidor som Bing identifierade under en viss period anger du frågeparametern freshness till något av följande skiftlägesokänsliga värden:

  • Day – Returnera webbsidor som Bing har identifierat under de senaste 24 timmarna
  • Week – Returnera webbsidor som Bing har identifierat under de senaste 7 dagarna
  • Month – Returnera webbsidor som upptäckts under de senaste 30 dagarna

Du kan också ange den här parametern till ett anpassat datumintervall i formuläret . YYYY-MM-DD..YYYY-MM-DD

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

Om du vill begränsa resultatet till ett enda datum anger du parametern freshness till ett specifikt datum:

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

Resultatet kan omfatta webbsidor som ligger utanför den angivna perioden om antalet webbsidor som Bing matchar dina filtervillkor är mindre än antalet webbsidor som du begärde (eller standardnumret som Bing returnerar).

Begränsa antalet svar i svaret

Bing kan returnera flera svarstyper i JSON-svaret. Om du till exempel kör frågor mot sailing+dinghies kan Bing returnera webpages, images, videosoch relatedSearches.

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

Om du vill begränsa antalet svar som Bing returnerar till de två främsta svaren (webbsidor och bilder) anger du frågeparametern answerCount till 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

Svaret innehåller endast webPages och images.

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

Om du lägger till responseFilter frågeparametern i den föregående frågan och anger den till webbsidor och nyheter innehåller svaret endast webbsidor eftersom nyheter inte rangordnas.

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

Främja svar som inte rangordnas

Om de högst rankade svaren som Bing returnerar för en fråga är webbsidor, bilder, videor och relatedSearches innehåller svaret dessa svar. Om du ställer in answerCount på två (2) returnerar Bing de två främsta svaren: webbsidor och bilder. Om du vill att Bing ska inkludera bilder och videor i svaret anger du frågeparametern promote och ställer in den på bilder och videor.

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

Följande är svaret på ovanstående begäran. Bing returnerar de två främsta svaren, webbsidor och bilder, och höjer upp videor till svaret.

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

Om du anger promote nyheter innehåller svaret inte nyhetssvaret eftersom det inte är ett rangordnat svar – du kan bara höja upp rankade svar.

Svaren som du vill höja upp räknas inte mot answerCount gränsen. Om de rankade svaren till exempel är nyheter, bilder och videor, och du anger answerCount till 1 och promote till nyheter, innehåller svaret nyheter och bilder. Eller om de rankade svaren är videor, bilder och nyheter innehåller svaret videor och nyheter.

Du kan bara använda promote om du anger frågeparametern answerCount .