Bing Arama API'lerinden sonuçları sayfalandırma

  • Makale

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 Web, Özel, Görüntü, Haber veya Video Arama API'lerine çağrı gönderdiğinizde, Bing sorguyla ilgili olabilecek toplam sonuç sayısının bir alt kümesini döndürür. Kullanılabilir sonuçların tahmini toplam sayısını almak için yanıt nesnesinin alanına erişin totalEstimatedMatches .

Örnek:

{
    "_type" : "SearchResponse",
    "webPages" : {
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA...",
        "totalEstimatedMatches" : 262000,
        "value" : [...]
    }
}

Arama sonuçlarından sayfalama

Kullanılabilir sonuçları sayfalandırmak için isteğinizi gönderirken ve offset sorgu parametrelerini kullanıncount.

Not

  • Bing Video, Görüntü ve Haber API'leriyle sayfalama yalnızca genel video (), haberler (/video/search) ve resim (/news/search/image/search) aramalarına uygulanır. Popüler konular ve kategoriler aracılığıyla sayfalama desteklenmez.
  • Alanı TotalEstimatedMatches , geçerli sorgunun toplam arama sonuçlarının sayısıyla ilgili bir tahmindir. ve offset parametrelerini ayarladığınızda count bu tahmin değişebilir.
Parametre Açıklama
count Yanıtta döndürülecek sonuç sayısını belirtir. varsayılan değerinin countve isteyebileceğiniz en fazla sonuç sayısının API'ye göre farklılık gösterdiğini unutmayın. Bu değerleri Sonraki adımlar altındaki başvuru belgelerinde bulabilirsiniz.
offset Atlana sonuçların sayısını belirtir. offset sıfır tabanlıdır ve değerinden küçük olmalıdır.totalEstimatedMatches - count

Örneğin, sayfa başına 15 sonuç görüntülemek istiyorsanız, sonuçların ilk sayfasını almak için 15 ve offset 0 olarak ayarlanırcount. Sonraki her API çağrısı için 15 artırabilirsiniz offset . Aşağıdaki örnek, 45 uzaklığından başlayarak 15 web sayfası istemektedir.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&count=15&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

Varsayılan count değeri kullanırsanız, yalnızca API çağrılarınızda sorgu parametresini belirtmeniz offset gerekir.

GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&offset=45&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
Host: api.cognitive.microsoft.com

Bing Resim ve Video API'lerini kullanırken, yinelenen arama sonuçlarından nextOffset kaçınmak için değerini kullanabilirsiniz. veya Videos yanıt nesnelerinden Images değeri alın ve parametresiyle offset isteklerinizde kullanın.

Not

Bing Web Araması API'si web sayfalarını, resimleri, videoları ve haberleri içerebilen arama sonuçlarını döndürür. Bing Web Araması API'sinden arama sonuçlarına göz attığınızda, görüntüler veya haberler gibi diğer yanıt türlerini değil, yalnızca Web Sayfalarını sayfalarsınız. Nesnelerdeki WebPage arama sonuçları, diğer yanıt türlerinde de görünen sonuçlar içerebilir.

Herhangi bir filtre değeri belirtmeden sorgu parametresini kullanırsanız responseFilter ve offset parametrelerini kullanmayıncount.

Sonraki adımlar