Rövid útmutató: A Bing Web Search API meghívása a Python segítségével
Figyelmeztetés
2020. október 30-án a Bing Search API-k átkerültek az Azure AI-szolgáltatásokból a Bing Search-szolgáltatásokba. Ez a dokumentáció csak referenciaként érhető el. A frissített dokumentációt a Bing search API dokumentációjában találja. Az új Azure-erőforrások Bing-kereséshez való létrehozásával kapcsolatos utasításokért lásd: Bing Search-erőforrás létrehozása a Azure Marketplace keresztül.
Ezzel a rövid útmutatóval kezdeményezheti első hívását a Bing Web Search API-hoz. Ez a Python-alkalmazás keresési kérést küld az API-nak, és megjeleníti a JSON-választ. Bár ez az alkalmazás Pythonban van megírva, az API egy RESTful webszolgáltatás, amely kompatibilis a legtöbb programozási nyelvvel.
Ez a példa Jupyter-notebookként van futtatva a MyBinderben. A futtatásához válassza a launch binder jelvényt:
Előfeltételek
Azure-erőforrás létrehozása
Kezdje el használni a Bing Web Search API-t az alábbi Azure-erőforrások egyikének létrehozásával:
- A Azure Portal keresztül érhető el, amíg el nem törli az erőforrást.
- Az ingyenes tarifacsomag használatával próbálja ki a szolgáltatást, és frissítsen később egy fizetős tarifacsomagra éles környezetben.
- A Azure Portal keresztül érhető el, amíg el nem törli az erőforrást.
- Használja ugyanazt a kulcsot és végpontot az alkalmazásokhoz több Azure AI-szolgáltatásban.
Változók meghatározása
Cserélje le a
subscription_key
értékét egy érvényes előfizetői azonosítóra az Azure-fiókjából.subscription_key = "YOUR_ACCESS_KEY" assert subscription_key
Deklarálja a Bing Web Search API végpontját. Használhatja a globális végpontot a következő kódban, vagy használhatja az erőforráshoz tartozó Azure Portal megjelenített egyéni altartományvégpontot.
search_url = "https://api.bing.microsoft.com/v7.0/search"
Igény szerint testre szabhatja a keresési lekérdezést
search_term
a értékének lecserélésével.search_term = "Azure Cognitive Services"
Kérés indítása
Ez a kód a requests
kódtár használatával hívja meg a Bing Web Search API-t, és JSON-objektumként adja vissza az eredményeket. Az API-kulcs a headers
szótárban lesz átadva, a keresési kifejezést és a lekérdezés paramétereit pedig a params
szótárban.
A lehetőségek és paraméterek teljes listáját lásd: Bing Web Search API 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()
A válasz formázása és megjelenítése
Az search_results
objektum tartalmazza a keresési eredményeket, valamint az olyan metaadatokat, mint a kapcsolódó lekérdezések és lapok. Ez a kód az IPython.display
kódtár segítségével formázza és jeleníti meg a választ a böngészőjében.
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))
Mintakód a GitHubon
A kód helyi futtatásához tekintse meg a GitHubon elérhető teljes mintát.