Arama yanıtının içerdiği yanıtları filtreleme
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.
Web'i sorguladığınızda Bing, arama için bulduğu tüm ilgili içeriği döndürür. Örneğin, arama sorgusu "sailing+dinghies" ise yanıt aşağıdaki yanıtları içerebilir:
{
"_type" : "SearchResponse",
"webPages" : {
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43C...",
"totalEstimatedMatches" : 262000,
"value" : [...]
},
"images" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",
"readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA5CA6464E5D...",
"isFamilyFriendly" : true,
"value" : [...]
},
"rankingResponse" : {
"mainline" : {
"items" : [...]
}
}
}
Sorgu parametreleri
Bing tarafından döndürülen yanıtları filtrelemek için API'yi çağırırken aşağıdaki sorgu parametrelerini kullanın.
ResponseFilter
Yanıtların virgülle ayrılmış listesi olan responseFilter sorgu parametresini kullanarak Bing'in yanıta dahil ettiği yanıt türlerini (örneğin resimler, videolar ve haberler) filtreleyebilirsiniz. Bing ilgili içeriği bulursa yanıta bir yanıt eklenir.
Görüntüler gibi belirli yanıtları yanıttan hariç tutmak için, yanıt türüne bir - karakter ekleyin. Örnek:
&responseFilter=-images,-videos
Aşağıda, yelkenli yeleklerin görüntülerini, videolarını ve haberlerini istemek için nasıl kullanılacağı responseFilter gösterilmektedir. Sorgu dizesini kodladığınızda virgüller %2C olarak değişir.
GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&responseFilter=images%2Cvideos%2Cnews&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: 47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
Aşağıda, bir önceki sorgunun yanıtı gösterilmektedir. Bing ilgili video ve haber sonuçlarını bulamadığından yanıt bunları içermez.
{
"_type" : "SearchResponse",
"images" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",
"readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3AD78B183C56456C...",
"isFamilyFriendly" : true,
"value" : [...]
},
"rankingResponse" : {
"mainline" : {
"items" : [{
"answerType" : "Images",
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images"
}
}]
}
}
}
Bing önceki yanıtta video ve haber sonuçları döndürmese de, video ve haber içeriğinin mevcut olmadığı anlamına gelmez. Bu basitçe sayfanın bunları içermediğini gösterir. Bununla birlikte, daha fazla sonuç sayfası açarsanız, sonraki sayfalar büyük olasılıkla bunları içerir. Ayrıca , Video Arama API'sini ve Haber Arama API'sinin uç noktalarını doğrudan çağırırsanız yanıt büyük olasılıkla sonuçlar içerir.
Tek bir API'den sonuç almak için kullanmanız responseFilter önerilmez. Tek bir Bing API'sinden içerik istiyorsanız bu API'yi doğrudan çağırabilirsiniz. Örneğin, yalnızca görüntüleri almak için Görüntü Arama API'sinin uç noktasına https://api.cognitive.microsoft.com/bing/v7.0/images/search veya diğer Görüntüler uç noktalarına bir istek gönderin. Tek API'yi çağırmak yalnızca performans nedenleriyle değil, içeriğe özgü API'ler daha zengin sonuçlar sunduğundan önemlidir. Örneğin, sonuçları filtrelemek için Web Araması API'sinde kullanılamayan filtreleri kullanabilirsiniz.
Site
Belirli bir etki alanından arama sonuçları almak için sorgu parametresini site: sorgu dizesine ekleyin.
https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us
Not
Sorguya bağlı olarak, sorgu işlecini site: kullanırsanız, güvenli Arama ayarından bağımsız olarak yanıtın yetişkinlere yönelik içerik içerme olasılığı vardır. site: işlecini yalnızca sitenin içeriği hakkında bilgi sahibiyseniz ve senaryonuz, yetişkinlere yönelik içeriğin mevcut olma ihtimalini destekliyorsa kullanın.
Güncellik
Web yanıtı sonuçlarını Bing'in belirli bir süre içinde keşfettiği web sayfalarıyla sınırlamak için , freshness sorgu parametresini aşağıdaki büyük/küçük harfe duyarlı olmayan değerlerden birine ayarlayın:
Day— Bing'in son 24 saat içinde keşfettiği web sayfalarını döndürWeek— Bing'in son 7 gün içinde keşfettiği web sayfalarını döndürMonth— Son 30 gün içinde bulunan web sayfalarını döndürme
Bu parametreyi biçimindeki YYYY-MM-DD..YYYY-MM-DDözel bir tarih aralığı olarak da ayarlayabilirsiniz.
https://<host>/bing/v7.0/search?q=ipad+updates&freshness=2019-02-01..2019-05-30
Sonuçları tek bir tarihle sınırlamak için freshness parametresini belirli bir tarihe ayarlayın:
https://<host>/bing/v7.0/search?q=ipad+updates&freshness=2019-02-04
Sonuçlar, Bing'in filtre ölçütlerinizle eşlediğiniz web sayfalarının sayısı istediğiniz web sayfası sayısından (veya Bing'in döndürdüğü varsayılan sayıdan) azsa belirtilen sürenin dışında kalan web sayfalarını içerebilir.
Yanıttaki yanıt sayısını sınırlama
Bing, JSON yanıtında birden çok yanıt türü döndürebilir. Örneğin, sailing+dinghies sorgularsanız, Bing , images, videosve relatedSearchesdöndürebilirwebpages.
{
"_type" : "SearchResponse",
"queryContext" : {
"originalQuery" : "sailing dinghies"
},
"webPages" : {...},
"images" : {...},
"relatedSearches" : {...},
"videos" : {...},
"rankingResponse" : {...}
}
Bing'in döndürdüğü yanıt sayısını ilk iki yanıtla (web sayfaları ve resimler) sınırlamak için answerCount sorgu parametresini 2 olarak ayarlayın.
GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: 47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
Yanıt yalnızca webPages ve imagesiçerir.
{
"_type" : "SearchResponse",
"queryContext" : {
"originalQuery" : "sailing dinghies"
},
"webPages" : {...},
"images" : {...},
"rankingResponse" : {...}
}
Sorgu parametresini responseFilter önceki sorguya ekleyip web sayfaları ve haberler olarak ayarlarsanız, haberler derecelenmediğinden yanıt yalnızca web sayfalarını içerir.
{
"_type" : "SearchResponse",
"queryContext" : {
"originalQuery" : "sailing dinghies"
},
"webPages" : {...},
"rankingResponse" : {...}
}
Dereceli olmayan yanıtları yükseltme
Bing'in sorgu için döndürdüğü en yüksek dereceli yanıtlar web sayfaları, resimler, videolar ve relatedSearches ise yanıt bu yanıtları içerir. answerCount değerini iki (2) olarak ayarlarsanız, Bing ilk iki dereceli yanıtı döndürür: web sayfaları ve resimler. Bing'in yanıta görüntü ve video eklemesini istiyorsanız sorguyu yükseltme parametresini belirtin ve görüntüler ve videolar olarak ayarlayın.
GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&promote=images%2Cvideos&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: 47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
Yukarıdaki isteğin yanıtı aşağıdadır. Bing, web sayfaları ve resimler gibi en iyi iki yanıtı döndürür ve videoları yanıta yükseltmektedir.
{
"_type" : "SearchResponse",
"queryContext" : {
"originalQuery" : "sailiing dinghies"
},
"webPages" : {...},
"images" : {...},
"videos" : {...},
"rankingResponse" : {...}
}
Haberlere ayarlarsanız promote yanıt, dereceli bir yanıt olmadığından haber yanıtını içermez; yalnızca dereceli yanıtları yükseltebilirsiniz.
Yükseltmek istediğiniz yanıtlar sınıra answerCount karşı sayılmaz. Örneğin, dereceli yanıtlar haberler, resimler ve videolar ise ve 1 ve promote haberler olarak ayarlanırsaanswerCount, yanıt haberler ve görüntüler içerir. Ya da dereceli yanıtlar videolar, resimler ve haberlerse yanıtta videolar ve haberler bulunur.
Yalnızca sorgu parametresini answerCount belirtirseniz kullanabilirsinizpromote.