Filtrare i riscontri inclusi nella risposta della ricerca

Articolo
07/08/2019

Avviso

Il 30 ottobre 2020 le API Ricerca Bing sono state spostate dai servizi di intelligenza artificiale di Azure ai servizi di Ricerca Bing. Questa documentazione viene fornita solo per riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite il Azure Marketplace.

Quando si eseguono query nel Web, Bing restituisce tutto il contenuto rilevante che trova per la ricerca. Ad esempio, se la query di ricerca è "sailing+dinghies" (derive), la risposta potrebbe contenere i riscontri seguenti:

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

Parametri di query

Per filtrare le risposte restituite da Bing, usare i parametri di query seguenti quando si chiama l'API.

ResponseFilter

È possibile filtrare i tipi di risposte che Bing include nella risposta (ad esempio immagini, video e notizie) usando il parametro di query responseFilter , che è un elenco delimitato da virgole di risposte. Una risposta verrà inclusa nella risposta se Bing trova contenuto pertinente.

Per escludere risposte specifiche dalla risposta, ad esempio immagini, anteporre un - carattere al tipo di risposta. Ad esempio:

&responseFilter=-images,-videos

L'esempio seguente mostra come usare responseFilter per richiedere immagini, video e notizie relative alle derive. Per la codifica di questa stringa di query, le virgole diventano %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

Di seguito è riportata la risposta alla query precedente. Poiché Bing non ha trovato video e notizie rilevanti come risultati, la risposta non li include.

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

Anche se Bing non ha restituito risultati per video e notizie nella risposta precedente, non significa che non esiste contenuto video e di notizie. Indica semplicemente che la pagina non ha incluso questo contenuto. Tuttavia, se si scorrono altre pagine per visualizzare più risultati, è probabile che le pagine successive includano questo tipo di contenuto. Inoltre, se si chiamano direttamente gli endpoint API Ricerca video e API Ricerca notizie, la risposta conterrà probabilmente risultati.

È sconsigliato l'uso di responseFilter per ottenere risultati da una singola API. Se si vuole ottenere contenuto da una singola API di Bing, chiamare direttamente tale API. Ad esempio, per ricevere solo le immagini, inviare una richiesta all'endpoint API Ricerca immagini https://api.cognitive.microsoft.com/bing/v7.0/images/search o uno degli altri endpoint Immagini. Chiamare l'API specifica è importante non solo per motivi di prestazioni, ma anche perché le API per contenuto specifico offrono risultati migliori. Ad esempio, è possibile usare filtri che non sono disponibili per l'API Ricerca Web per filtrare i risultati.

Sito

Per ottenere i risultati della ricerca da un dominio specifico, includere il site: parametro di query nella stringa di query.

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

Nota

A seconda della query, se si usa l'operatore di query site:, la risposta potrebbe includere contenuto per adulti indipendentemente dall'impostazione di safeSearch. È consigliabile usare site: solo se si conosce il contenuto del sito e lo scenario prevede la possibilità di contenuto per adulti.

Aggiornamento

Per limitare i risultati della risposta Web alle pagine Web individuate da Bing durante un periodo specifico, impostare il parametro di query di aggiornamento su uno dei valori senza distinzione tra maiuscole e minuscole seguenti:

Day — Restituire le pagine Web individuate da Bing nelle ultime 24 ore
Week — Restituire pagine Web individuate da Bing negli ultimi 7 giorni
Month — Restituire pagine Web individuate negli ultimi 30 giorni

È anche possibile impostare questo parametro su un intervallo di date personalizzato nel formato , YYYY-MM-DD..YYYY-MM-DD.

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

Per limitare i risultati a una singola data, impostare il parametro freshness su una data specifica:

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

I risultati possono includere pagine Web che non rientrano nel periodo specificato se il numero di pagine Web che Bing corrisponde ai criteri di filtro è minore del numero di pagine Web richieste (o il numero predefinito restituito da Bing).

Limitazione del numero di riscontri nella risposta

Bing può restituire più tipi di risposte nella risposta JSON. Ad esempio, se si esegue una query su sailing+dinghies, Bing potrebbe restituire webpages, , imagesvideose relatedSearches.

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

Per limitare il numero di riscontri restituiti da Bing ai primi due (pagine Web e immagini), impostare il parametro di query answerCount su 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

La risposta include solo webPages e images.

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

Se si aggiunge il parametro di query responseFilter alla query precedente e si imposta il filtro per pagine Web e notizie, la risposta contiene solo pagine Web perché le notizie non sono classificate.

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

Alzare di livello i riscontri non classificati

Se i riscontri con classificazione migliore restituiti da Bing per una query sono pagine Web, immagini, video e ricerche correlate, la risposta includerà questi riscontri. Se si imposta answerCount su due (2), Bing restituisce i primi due riscontri nella classificazione, ovvero pagine Web e immagini. Se si vuole che Bing includa immagini e video nella risposta, specificare il parametro di query promote e impostarlo su images e videos.

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

Di seguito è indicata la risposta alla richiesta precedente. Bing restituisce i primi due riscontri, ovvero pagine Web e immagini, quindi alza di livello i video nel riscontro.

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

Se si imposta promote su notizie, la risposta non include la risposta alle notizie perché non è una risposta classificata, ma è possibile promuovere solo le risposte classificate.

I riscontri che si vogliono alzare di livello non vengono inclusi incluso nel calcolo del limite di answerCount. Ad esempio, se i riscontri classificati sono notizie, immagini e video e si imposta answerCount su 1 e promote su news, la risposta contiene notizie e immagini. In alternativa, se i riscontri classificati sono video, immagini e notizie, la risposta contiene video e notizie.

È possibile usare promote solo se si specifica il parametro di query answerCount.