Guida introduttiva: Usare Python per chiamare l'API Ricerca Web Bing

Articolo
05/22/2020

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 di Ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per Ricerca Bing, vedere Creare una risorsa di Ricerca Bing tramite Azure Marketplace.

Usare questa guida introduttiva per effettuare la prima chiamata all'API Ricerca Web Bing. Questa applicazione Python invia una richiesta di ricerca all'API e mostra la risposta JSON. Anche se questa applicazione è scritta in Python, l'API è un servizio Web RESTful compatibile con la maggior parte dei linguaggi di programmazione.

Questo esempio viene eseguito come notebook di Jupyter in MyBinder. Per eseguirlo, selezionare il badge di avvio:

Prerequisiti

Python 2.x o 3.x

Creare una risorsa di Azure

Iniziare a usare l'API Ricerca Web Bing creando una delle risorse di Azure seguenti:

risorsa ricerca Bing v7

Disponibile tramite il portale di Azure fino a quando non si elimina la risorsa.
Usare il piano tariffario gratuito per provare il servizio e eseguire l'aggiornamento in un secondo momento a un livello a pagamento per la produzione.

risorsa multifunzionale

Disponibile tramite il portale di Azure fino a quando non si elimina la risorsa.
Usare la stessa chiave e lo stesso endpoint per le applicazioni in più servizi di intelligenza artificiale di Azure.

Definire le variabili

Sostituire il valore subscription_key con una chiave di sottoscrizione valida dall'account Azure.
```
subscription_key = "YOUR_ACCESS_KEY"
assert subscription_key
```
Dichiarare l'endpoint dell'API Ricerca Web Bing. È possibile usare l'endpoint globale nel codice seguente oppure usare il sottodominio personalizzato endpoint visualizzato nel portale di Azure per la risorsa.
```
search_url = "https://api.bing.microsoft.com/v7.0/search"
```
Puoi opzionalmente personalizzare la query di ricerca sostituendo il valore per search_term.
```
search_term = "Azure Cognitive Services"
```

Effettuare una richiesta

Questo codice usa la libreria di requests per chiamare l'API Ricerca Web Bing e restituire i risultati come oggetto JSON. La chiave API viene passata nel dizionario headers e i parametri di ricerca e query vengono passati nel dizionario params.

Per un elenco completo di opzioni e parametri, vedere API Ricerca Web Bing v7.

import requests

headers = {"Ocp-Apim-Subscription-Key": subscription_key}
params = {"q": search_term, "textDecorations": True, "textFormat": "HTML"}
response = requests.get(search_url, headers=headers, params=params)
response.raise_for_status()
search_results = response.json()

Formattare e visualizzare la risposta

L'oggetto search_results include i risultati della ricerca e metadati come query e pagine correlate. Questo codice usa la libreria IPython.display per formattare e visualizzare la risposta nel browser.

from IPython.display import HTML

rows = "\n".join(["""<tr>
                       <td><a href=\"{0}\">{1}</a></td>
                       <td>{2}</td>
                     </tr>""".format(v["url"], v["name"], v["snippet"])
                  for v in search_results["webPages"]["value"]])
HTML("<table>{0}</table>".format(rows))

Codice di esempio in GitHub

Per eseguire questo codice in locale, vedere l'esempio completo disponibile in GitHub.

Passaggi successivi

esercitazione 'app a pagina singola dell'API Ricerca Web Bing

Condividi tramite