Come eseguire la pagina dei risultati dalle API di Ricerca Bing

  • Articolo

Avviso

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

Quando si invia una chiamata al Web Bing, Custom, Image, News o Video Search API, Bing restituisce un subset del numero totale di risultati che potrebbero essere rilevanti per la query. Per ottenere il numero totale stimato di risultati disponibili, accedere al campo dell'oggetto totalEstimatedMatches risposta.

Ad esempio:

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

Paging tramite i risultati della ricerca

Per visualizzare i risultati disponibili, usare i count parametri di query e offset durante l'invio della richiesta.

Nota

  • Il paging con le API Video, immagine e notizie Bing si applica solo ai video generali (), alle notizie (/news/search) e alle ricerche di immagini ()./video/search/image/search Il paging tra argomenti e categorie di tendenza non è supportato.
  • Il TotalEstimatedMatches campo è una stima del numero totale di risultati della ricerca per la query corrente. Quando si impostano i count parametri e offset , questa stima può cambiare.
Parametro Descrizione
count Specifica il numero di risultati da restituire nella risposta. Si noti che il valore predefinito di counte il numero massimo di risultati che è possibile richiedere varia in base all'API. È possibile trovare questi valori nella documentazione di riferimento in Passaggi successivi.
offset Specifica il numero di risultati da ignorare. offset è in base zero e deve essere inferiore a (totalEstimatedMatches - count).

Ad esempio, se si desidera visualizzare 15 risultati per pagina, si imposta count su 15 e offset su 0 per ottenere la prima pagina dei risultati. Per ogni chiamata API successiva, si incrementerebbe offset di 15. Di seguito viene illustrato un esempio che richiede 15 pagine Web che iniziano in corrispondenza dell'offset 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

Se si usa il valore predefinito count , è necessario specificare solo il offset parametro di query nelle chiamate 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

Quando si usano le API Immagini e video Bing, è possibile usare il nextOffset valore per evitare risultati di ricerca duplicati. Ottenere il valore dagli Images oggetti o Videos di risposta e usarlo nelle richieste con il offset parametro .

Nota

L'API Ricerca Web Bing restituisce i risultati della ricerca che possono includere pagine Web, immagini, video e notizie. Quando si visualizzano i risultati della ricerca dall'API Ricerca Web Bing, si sta pagando solo WebPages e non altri tipi di risposta, ad esempio immagini o notizie. I risultati della ricerca negli WebPage oggetti possono includere anche i risultati visualizzati in altri tipi di risposte.

Se si usa il responseFilter parametro di query senza specificare alcun valore di filtro, non usare i count parametri e offset .

Passaggi successivi