Share via


Hızlı Başlangıç: Python ve Bing Haber Arama REST API'sini kullanarak haber araması gerçekleştirme

Uyarı

30 Ekim 2020'de Bing Arama API'leri Azure yapay zeka hizmetlerinden Bing Arama Hizmetlerine taşındı. Bu belgeler yalnızca başvuru için sağlanır. Güncelleştirilmiş belgeler için Bing arama API'sinin belgelerine bakın. Bing araması için yeni Azure kaynakları oluşturma yönergeleri için bkz. Azure Market aracılığıyla Bing Arama kaynağı oluşturma.

Bing Haber Arama API'sine ilk çağrınızı yapmak için bu hızlı başlangıcı kullanın. Bu basit Python uygulaması API'ye bir arama sorgusu gönderir ve JSON sonucunu işler.

Bu uygulama Python'da yazılmış olsa da, API çoğu programlama diliyle uyumlu bir RESTful Web hizmetidir.

Bu kod örneğini MyBinder'da Jupyter not defteri olarak çalıştırmak için bağlayıcıyı başlatma rozetini seçin:

bağlayıcıyı başlatma

Bu örneğin kaynak kodu GitHub'da da kullanılabilir.

Azure kaynağı oluşturma

Aşağıdaki Azure kaynaklarından birini oluşturarak Bing Haber Arama API'sini kullanmaya başlayın:

Bing Arama v7 kaynağı

  • Kaynağı silene kadar Azure portal aracılığıyla kullanılabilir.
  • Hizmeti denemek için ücretsiz fiyatlandırma katmanını kullanın ve daha sonra üretim için ücretli bir katmana yükseltin.

Çok hizmetli kaynak

  • Kaynağı silene kadar Azure portal aracılığıyla kullanılabilir.
  • Birden çok Azure AI hizmeti genelinde uygulamalarınız için aynı anahtarı ve uç noktayı kullanın.

Uygulamayı oluşturma ve başlatma

Sık kullandığınız IDE veya düzenleyicide yeni bir Python dosyası oluşturun ve istek modülünü içeri aktarın. Abonelik anahtarınız, uç noktanız ve arama teriminiz için değişkenler oluşturun. Aşağıdaki kodda genel uç noktayı kullanabilir veya kaynağınız için Azure portal görüntülenen özel alt etki alanı uç noktasını kullanabilirsiniz.

import requests

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

İstek için parametreler oluşturma

Anahtar olarak kullanarak Ocp-Apim-Subscription-Key abonelik anahtarınızı yeni bir sözlüğe ekleyin. Aynı işlemi arama parametreleriniz için de yapın.

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

İstek gönderme ve yanıt alma

  1. Bing Görsel Arama API'sini abonelik anahtarınızla ve önceki adımda oluşturduğunuz sözlük nesneleriyle çağırmak için istek kitaplığını kullanın.

    response = requests.get(search_url, headers=headers, params=params)
    response.raise_for_status()
    search_results = json.dumps(response.json())
    
  2. Yanıtta yer alan makalelerin açıklamalarına JSON nesnesi olarak depolanan API'den search_results erişin.

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

Sonuçları görüntüleme

Bu açıklamalardan arama anahtar sözcüklerinin kalın yazıldığı bir tablo oluşturulabilir.

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

Sonraki adımlar