Megosztás a következőn keresztül:


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:

Binder

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:

Bing Search v7-erőforrás

  • 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.

Többszolgáltatásos erőforrás

  • 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

  1. 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
    
  2. 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"
    
  3. Igény szerint testre szabhatja a keresési lekérdezést search_terma é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.

Következő lépések

Lásd még