Bing Web Araması API'si sonuçlarını görüntülemek için derecelendirmeyi kullanma
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.
Her arama yanıtı, arama sonuçlarını nasıl görüntülemeniz gerektiğini belirten bir RankingResponse yanıtı içerir. Derecelendirme yanıtı, geleneksel bir arama sonuçları sayfası için sonuçları ana satır içeriğine ve kenar çubuğu içeriğine göre gruplandırr. Sonuçları geleneksel bir ana hat ve kenar çubuğu biçiminde görüntülemezseniz, ana satır içeriğini kenar çubuğu içeriğinden daha yüksek görünürlük sağlamanız gerekir.
Her grup içinde (ana hat veya kenar çubuğu), Items dizisi içeriğin gösterilmesi gereken sırayı tanımlar. Her öğe, yanıtın içindeki sonucu tanımlamak için aşağıdaki iki yolu sağlar.
answerTypeveresultIndex— AlanıanswerTypeyanıtı (örneğin, Web sayfası veya Haberler) tanımlar veresultIndexyanıttaki bir sonucu (örneğin, bir haber makalesi) tanımlar. Dizin sıfır tabanlıdır.value— Alan,valueyanıtın kimliğiyle veya yanıttaki bir sonuçla eşleşen bir kimlik içerir. Yanıt veya sonuçlar kimliği içerir ancak ikisini birden içermez.
Derecelendirme kimliğini yalnızca bir yanıtın kimliğiyle veya sonuçlarından biriyle eşleştirmeniz gerektiğinden, kimliği kullanmak daha kolaydır. Yanıt nesnesi bir id alan içeriyorsa, yanıtın tüm sonuçlarını birlikte görüntüleyin. Örneğin, News nesne alanı içeriyorsa id , tüm haber makalelerini birlikte görüntüleyin. Nesne alanı News içermiyorsa, her haber makalesi id bir id alan içerir ve derecelendirme yanıtı haber makalelerini diğer yanıtlardan gelen sonuçlarla karıştırır.
ve resultIndex kullanmak answerType biraz daha karmaşıktır. Görüntülenecek sonuçları içeren yanıtı tanımlamak için kullanırsınız answerType . Ardından, sonucun görüntülenmesini sağlamak için yanıtın sonuçlarını dizine almak için komutunu kullanırsınız resultIndex . (Değer answerTypeSearchResponse nesnesindeki alanın adıdır.) Yanıtın tüm sonuçlarını birlikte görüntülemeniz gerekiyorsa, derecelendirme yanıt öğesi alanı resultIndex içermez.
Derecelendirme yanıtı örneği
Aşağıda örnek bir RankingResponse gösterilmektedir. Web yanıtı bir id alan içermediğinden, tüm web sayfalarını derecelendirmeye göre ayrı ayrı görüntülersiniz (her web sayfası bir id alan içerir). Görüntüler, videolar ve ilgili arama yanıtları alanı içerdiğinden id , derecelendirmeye göre bu yanıtların her birinin sonuçlarını birlikte görüntülersiniz.
{
"_type" : "SearchResponse",
"webPages" : {
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=96C4CF214...",
"totalEstimatedMatches" : 835000,
"value" : [
{
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#WebPages.0",
"name" : "Motor Sports - Live at the race track ...",
"url" : "http:\/\/www.bing.com\/cr?IG=96C4CF214A0A43...",
"displayUrl" : "www.contoso.com\/usa\/eventsandracing\/motorsport",
"snippet" : "Here you will find detailed information about racing...",
"deepLinks" : [{
"name" : "Customer Racing",
"url" : "http:\/\/www.bing.com\/cr?IG=96C4CF214A0A43...",
"snippet" : "Customer racing news; General news..."
},
. . .
]
}],
"images" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",
"readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images...",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=96C4CF214A...",
"isFamilyFriendly" : true,
"value" : [
{
"name" : "2016 Supercar Wallpapers",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=96C4...",
"thumbnailUrl" : "https:\/\/tse1.mm.bing.net\/th?id=OIP...",
"datePublished" : "2017-03-25T11:14:00",
"contentUrl" : "http:\/\/www.contoso.com\/wall...",
"hostPageUrl" : "http:\/\/www.bing.com\/cr?IG=96C4CF214...",
"contentSize" : "373283 B",
"encodingFormat" : "jpeg",
"hostPageDisplayUrl" : "http:\/\/www.contoso.com\/lmp-...",
"width" : 1920,
"height" : 1080,
"thumbnail" : {
"width" : 300,
"height" : 168
},
"insightsSourcesSummary" : {
"shoppingSourcesCount" : 0,
"recipeSourcesCount" : 0
}
},
. . .
]
},
"relatedSearches" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#RelatedSearches",
"value" : [
{
"text" : "vintage racing teams",
"displayText" : "vintage racing teams",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=96C4CF2..."
},
. . .
]
},
"videos" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Videos",
"readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/videos...",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=96C4CF214A...",
"isFamilyFriendly" : true,
"value" : [
{
"name" : "Why We Race",
"description" : "A new era begins in motorsports this weekend...",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=96C4CF2...",
"thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=OVP.Vo1...",
"datePublished" : "2014-01-25T16:31:48",
"publisher" : [
{
"name" : "Fabrikam"
}
],
"contentUrl" : "https:\/\/www.fabrikam.com\/watch?v=oL...",
"hostPageUrl" : "https:\/\/www.bing.com\/cr?IG=96C4CF214...",
"encodingFormat" : "mp4",
"hostPageDisplayUrl" : "https:\/\/www.fabrikam.com\/watch?v=oLAZgD...",
"width" : 480,
"height" : 360,
"duration" : "PT2M42S",
"motionThumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=OM...",
"embedHtml" : "<iframe width=\"1280\" height=\"720\" src=\"http:\/\/www.you...<\/iframe>",
"allowHttpsEmbed" : true,
"viewCount" : 47325,
"thumbnail" : {
"width" : 300,
"height" : 168
},
"allowMobileEmbed" : true,
"isSuperfresh" : false
},
. . .
]
},
"rankingResponse" : {
"mainline" : {
"items" : [{
"answerType" : "WebPages",
"resultIndex" : 0,
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#WebPages.0"
}
},
{
"answerType" : "Images",
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images"
}
},
{
"answerType" : "WebPages",
"resultIndex" : 1,
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#WebPages.1"
}
},
{
"answerType" : "WebPages",
"resultIndex" : 2,
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#WebPages.2"
}
},
{
"answerType" : "Videos",
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Videos"
}
},
{
"answerType" : "WebPages",
"resultIndex" : 3,
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#WebPages.3"
}
},
{
"answerType" : "WebPages",
"resultIndex" : 4,
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#WebPages.4"
}
},
{
"answerType" : "WebPages",
"resultIndex" : 5,
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#WebPages.5"
}
}]
},
"sidebar" : {
"items" : [{
"answerType" : "RelatedSearches",
"value" : {
"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#RelatedSearches"
}
}]
}
}
}
Bu derecelendirme yanıtına bağlı olarak, ana satır aşağıdaki arama sonuçlarını görüntüler:
- İlk web sayfası sonucu
- Tüm görüntüler
- İkinci ve üçüncü web sayfası sonuçları
- Tüm videolar
- 4., 5. ve 6. web sayfası sonuçları
Kenar çubuğunda aşağıdaki arama sonuçları görüntülenir:
- tüm ilgili aramalar
Sonraki adımlar
Kaydedilmemiş sonuçları yükseltme hakkında bilgi için bkz . Dereceli olmayan yanıtları yükseltme.
Yanıttaki dereceli yanıt sayısını sınırlama hakkında bilgi için bkz. Yanıttaki yanıt sayısını sınırlama.
Sonuçları görüntülemek için derecelendirme kullanan bir C# örneği için bkz. C# derecelendirme öğreticisi.