Arama yanıtının içerdiği yanıtları filtreleme

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

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ür
• Week — Bing'in son 7 gün içinde keşfettiği web sayfalarını döndür
• Month — 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.