Rychlý start: Vyhledávání zpráv pomocí Pythonu a rozhraní REST API Bingu pro vyhledávání zpráv

Upozornění

30. října 2020 se rozhraní API Vyhledávání Bingu přesunula ze služeb Azure AI na Vyhledávání Bingu Services. Tato dokumentace je k dispozici pouze pro referenci. Aktualizovanou dokumentaci najdete v dokumentaci k rozhraní API bingu pro vyhledávání. Pokyny k vytváření nových prostředků Azure pro vyhledávání Bingem najdete v tématu Vytvoření prostředku Vyhledávání Bingu prostřednictvím Azure Marketplace.

Pomocí tohoto rychlého startu můžete provést první volání rozhraní API Bingu pro vyhledávání zpráv. Tato jednoduchá aplikace Pythonu odešle do rozhraní API vyhledávací dotaz a zpracuje výsledek JSON.

I když je tato aplikace napsaná v Pythonu, rozhraní API je webová služba RESTful kompatibilní s většinou programovacích jazyků.

Pokud chcete tuto ukázku kódu spustit jako poznámkový blok Jupyter na MyBinderu, vyberte odznak spouštěcího pořadače :

spouštěcí pořadač

Zdrojový kód pro tuto ukázku je k dispozici také na GitHubu.

Vytvoření prostředku Azure

Začněte používat rozhraní API Bingu pro vyhledávání zpráv vytvořením jednoho z následujících prostředků Azure:

prostředek Vyhledávání Bingu v7

  • Dostupné prostřednictvím Azure Portal, dokud prostředek neodstraníte.
  • K vyzkoušení služby použijte bezplatnou cenovou úroveň a později upgradujte na placenou úroveň pro produkční prostředí.

Prostředek s více službami

  • Dostupné prostřednictvím Azure Portal, dokud prostředek neodstraníte.
  • Pro aplikace používejte stejný klíč a koncový bod napříč několika službami Azure AI.

Vytvoření a inicializace aplikace

Ve svém oblíbeném integrovaném vývojovém prostředí nebo editoru vytvořte nový soubor Pythonu a naimportujte modul žádosti. Vytvořte proměnné pro klíč předplatného, koncový bod a hledaný termín. Globální koncový bod můžete použít v následujícím kódu nebo vlastní koncový bod subdomény zobrazený v Azure Portal pro váš prostředek.

import requests

subscription_key = "your subscription key"
search_term = "Microsoft"
search_url = "https://api.cognitive.microsoft.com/bing/v7.0/news/search"

Vytvoření parametrů pro požadavek

Přidejte klíč předplatného do nového slovníku a použijte Ocp-Apim-Subscription-Key ho jako klíč. To samé udělejte pro parametry hledání.

headers = {"Ocp-Apim-Subscription-Key" : subscription_key}
params  = {"q": search_term, "textDecorations": True, "textFormat": "HTML"}

Odeslání požadavku a získání odpovědi

  1. Pomocí knihovny žádostí můžete volat rozhraní API Bingu pro vizuální vyhledávání s klíčem předplatného a objekty slovníku, které jste vytvořili v předchozím kroku.

    response = requests.get(search_url, headers=headers, params=params)
    response.raise_for_status()
    search_results = json.dumps(response.json())
    
  2. Přístup k popisům článků obsažených v odpovědi z rozhraní API, které je uložené jako search_results objekt JSON.

    descriptions = [article["description"] for article in search_results["value"]]
    

Zobrazení výsledků

Tyto popisy se potom dají vykreslit jako tabulka s vyhledávaným klíčovým slovem zvýrazněným tučným písmem.

from IPython.display import HTML
rows = "\n".join(["<tr><td>{0}</td></tr>".format(desc)
                  for desc in descriptions])
HTML("<table>"+rows+"</table>")

Další kroky