Hızlı Başlangıç: Python kullanarak Bing Özel Arama uç noktanızı çağırma

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 Özel Arama örneğinizden arama sonuçları isteme hakkında bilgi edinmek için bu hızlı başlangıcı kullanın. Bu uygulama Python'da yazılmış olsa da, Bing Özel Arama API'si çoğu programlama diliyle uyumlu bir RESTful web hizmetidir. Bu örneğin kaynak kodu GitHub'da kullanılabilir.

Önkoşullar

Azure kaynağı oluşturma

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

Bing Özel Arama 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.

Çoklu Hizmet kaynağı

  • 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 aşağıdaki içeri aktarma deyimlerini ekleyin. Abonelik anahtarınız, özel yapılandırma kimliğiniz ve arama teriminiz için değişkenler oluşturun.

    import json
    import requests
    
    subscriptionKey = "YOUR-SUBSCRIPTION-KEY"
    customConfigId = "YOUR-CUSTOM-CONFIG-ID"
    searchTerm = "microsoft"
    

Arama isteği gönderme ve alma

  1. Arama teriminizi sorgu parametresine ve arama örneğinizin özel yapılandırma kimliğini parametresine q= ekleyerek istek URL'sini customconfig= oluşturun. Parametreleri bir ve işaretiyle (&) ayırın. Genel uç noktayı aşağıdaki kodda kullanabilir veya kaynağınız için Azure portal görüntülenen özel alt etki alanı uç noktasını kullanabilirsiniz.

    url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
    
  2. İsteği Bing Özel Arama örneğine gönderin ve döndürülen arama sonuçlarını yazdırın.

    r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
    print(r.text)
    

Sonraki adımlar