Filtro delle risposte incluse nella risposta di ricerca

Avvertimento

Il 30 ottobre 2020, le API di ricerca Bing sono state spostate dai servizi di intelligenza artificiale di Azure ai servizi di ricerca Bing. Questa documentazione è disponibile 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 di Ricerca Bing tramite Azure Marketplace.

Quando si esegue una query sul Web, Bing restituisce tutto il contenuto pertinente trovato per la ricerca. Ad esempio, se la query di ricerca è "sailing+dinghies", la risposta potrebbe contenere le risposte 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 inclusi da Bing nella risposta (ad esempio immagini, video e notizie) usando il parametro di query responseFilter, ovvero un elenco di risposte delimitato da virgole. 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. Per esempio:

&responseFilter=-images,-videos

Di seguito viene illustrato come usare responseFilter per richiedere immagini, video e notizie sui dinghi a vela. Quando si codifica la stringa di query, le virgole vengono modificate in %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 viene illustrata la risposta alla query precedente. Poiché Bing non ha trovato risultati rilevanti relativi a video e notizie, 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 video e notizie nella risposta precedente, non significa che il contenuto video e notizie non esiste. Significa semplicemente che la pagina non li ha inclusi. Tuttavia, se si pagina tramite più risultati, è probabile che le pagine successive li includano. Inoltre, se si chiamano direttamente gli endpoint dell'API di ricerca video e dell'API di ricerca notizie , la risposta conterrà probabilmente risultati.

È sconsigliato usare responseFilter per ottenere risultati da una singola API. Per ottenere contenuto da una singola API Bing, chiamare direttamente l'API. Ad esempio, per ricevere solo immagini, inviare una richiesta all'endpoint dell'API Ricerca immagini, https://api.cognitive.microsoft.com/bing/v7.0/images/search o uno degli altri endpoint Immagini. La chiamata all'API singola è importante non solo per motivi di prestazioni, ma perché le API specifiche del contenuto offrono risultati più avanzati. Ad esempio, è possibile usare filtri non disponibili per l'API Ricerca Web per filtrare i risultati.

Sito

Per ottenere i risultati della ricerca da un dominio specifico, includere il parametro di query site: 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:, è possibile che la risposta contenga contenuto per adulti indipendentemente dall'impostazione safeSearch. È consigliabile usare site: solo se si è a conoscenza del contenuto nel sito e lo scenario supporta la possibilità di contenuto per adulti.

Freschezza

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

• Day : restituisce pagine Web individuate da Bing nelle ultime 24 ore
• Week : restituisce pagine Web individuate da Bing negli ultimi 7 giorni
• Month : restituisce 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 è inferiore al numero di pagine Web richieste (o il numero predefinito restituito da Bing).

Limitazione del numero di risposte nella risposta

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

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

Per limitare il numero di risposte restituite da Bing alle prime due risposte (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 lo si imposta su pagine Web e notizie, la risposta contiene solo pagine Web perché le notizie non vengono classificate.

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

Promozione di risposte non classificate

Se le risposte più classificate restituite da Bing per una query sono pagine Web, immagini, video e ricerche correlate, la risposta includerà tali risposte. Se si imposta answerCount su due (2), Bing restituisce le prime due risposte classificate: pagine Web e immagini. Se si vuole che Bing includa immagini e video nella risposta, specificare il parametro di query promuovi e impostarlo su immagini e video.

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 è riportata la risposta alla richiesta precedente. Bing restituisce le prime due risposte, pagine Web e immagini e promuove i video nella risposta.

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

Se si imposta promote sulle notizie, la risposta non include la risposta alle notizie perché non è una risposta classificata, ma è possibile alzare di livello solo le risposte classificate.

Le risposte che si desidera promuovere non sono incluse nel conteggio del limite answerCount. Ad esempio, se le risposte in ordine sono notizie, immagini e video, e si impostano answerCount su 1 e promote su notizie, la risposta conterrà notizie e immagini. In alternativa, se le risposte classificate sono video, immagini e notizie, la risposta contiene video e notizie.

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