Sorgu terimi önerme
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.
Genellikle, bir kullanıcı uygulamanızın arama kutusuna her yeni karakter gönderdiğinde Bing Otomatik Öneri API'sini çağırırsınız. Sorgu dizesinin eksiksiz olması, API’nin döndürdüğü önerilen sorgu terimlerinin alakasını etkiler. Sorgu dizesi ne kadar eksiksizse, önerilen sorgu terimlerinin listesi de o kadar alakalıdır. Örneğin, API'nin döndürebileceği öneriler için döndürdüğü ssailing dinghiessorgulardan daha az ilgili olabilir.
Örnek istek
Aşağıdaki örnekte, sail için önerilen sorgu dizelerini döndüren bir istek gösterilmektedir. q sorgu parametresini ayarladığınızda, kullanıcının kısmi sorgu terimini URL kodlamayı unutmayın. Örneğin, kullanıcı sailing dinghies terimini girdiyse, q öğesini sailing+les veya sailing%20les olarak ayarlayın.
GET https://api.cognitive.microsoft.com/bing/v7.0/suggestions?q=sail&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
Aşağıdaki yanıt, önerilen sorgu terimlerini içeren SearchAction nesnelerinin bir listesini içerir.
{
"url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
"displayText" : "sailing lessons seattle",
"query" : "sailing lessons seattle",
"searchKind" : "WebSearch"
}, ...
Önerilen sorgu terimlerini kullanma
Her öneri, displayText, query ve url alanını içerir. displayText alanı, arama kutunuzun açılır listesini doldurmak için kullandığınız önerilen sorguyu içerir. Yanıtın içerdiği tüm önerileri, verilen sırada görüntülemeniz gerekir.
Aşağıdaki örnekte, Bing Otomatik Öneri API'sinden önerilen sorgu terimlerini içeren bir açılan arama kutusu gösterilmektedir.
Kullanıcı, açılır listeden bir önerilen sorgu seçerse, query alanındaki sorgu terimini kullanarak Bing Web Araması API’sini çağırır ve sonuçları kendiniz görüntülersiniz. Veya bunun yerine kullanıcıyı Bing arama sonuçları sayfasına göndermek için url alanındaki URL’yi kullanabilirsiniz.