Cara menggunakan peringkat untuk menampilkan hasil Bing Web Search API
Peringatan
Pada 30 Oktober 2020, API Bing Search dipindahkan dari layanan Azure AI ke Bing Search Services. Dokumentasi ini disediakan hanya untuk referensi. Untuk dokumentasi terbaru, lihat dokumentasi Bing Search API. Untuk petunjuk tentang cara membuat sumber daya Azure baru untuk pencarian Bing, lihat Membuat sumber daya Pencarian Bing melalui Marketplace Azure.
Setiap respons pencarian menyertakan jawaban RankingResponse, yang menentukan bagaimana Anda harus menampilkan hasil pencarian. Grup respons peringkat menghasilkan konten jalur utama dan konten bilah samping untuk halaman hasil pencarian tradisional. Jika Anda tidak menampilkan hasilnya dalam format utama dan bilah samping tradisional, Anda harus memberikan visibilitas konten utama yang lebih tinggi daripada konten bilah samping.
Di dalam setiap grup (jalur utama atau bilah samping), array Item mengidentifikasi urutan konten harus muncul. Setiap item menyediakan dua cara berikut untuk mengidentifikasi hasil dalam jawaban.
answerTypedanresultIndex— BidanganswerTypemengidentifikasi jawaban (misalnya, Halaman Web atau Berita) danresultIndexmengidentifikasi hasil dalam jawaban (misalnya, artikel berita). Indeks berbasis nol.value— Bidangvalueberisi ID yang cocok dengan ID jawaban atau hasil dalam jawabannya. Apakah jawaban atau hasilnya yang berisi ID tetapi, bukan keduanya.
Menggunakan ID lebih mudah digunakan karena Anda hanya perlu mencocokkan ID peringkat dengan ID jawaban atau salah satu hasilnya. Jika objek jawaban menyertakan bidang id, tampilkan semua hasil jawaban bersama-sama. Misalnya, jika objek News menyertakan bidang id, tampilkan semua artikel berita bersama-sama. Jika objek News tidak menyertakan bidang id, setiap artikel berita berisi bidang id dan respons peringkat mencampur artikel berita dengan hasil dari jawaban lain.
Menggunakan answerType dan resultIndex sedikit lebih rumit. Anda menggunakan answerType untuk mengidentifikasi jawaban yang berisi hasil untuk ditampilkan. Kemudian, Anda menggunakan resultIndex untuk mengindeks hasil jawaban untuk mendapatkan hasilnya untuk ditampilkan. (Nilai answerType adalah nama bidang di objek SearchResponse). Jika Anda seharusnya menampilkan semua hasil jawaban bersama-sama, item respons peringkat tidak menyertakan bidang resultIndex.
Contoh respons peringkat
Berikut ini menunjukkan contoh RankingResponse. Karena jawaban Web tidak menyertakan bidang id, Anda akan menampilkan semua halaman web secara individual berdasarkan peringkat (setiap halaman web menyertakan bidang id). Dan karena gambar, video, dan jawaban pencarian terkait mencakup bidang id, Anda akan menampilkan hasil dari masing-masing jawaban tersebut bersama-sama berdasarkan peringkat.
{
"_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"
}
}]
}
}
}
Berdasarkan respons peringkat ini, jalur utama akan menampilkan hasil pencarian berikut:
- Hasil halaman web pertama
- Semua gambar
- Hasil halaman web kedua dan ketiga
- Semua video
- Hasil halaman web ke-4, ke-5, dan ke-6
Dan bilah samping akan menampilkan hasil pencarian berikut:
- Semua pencarian terkait
Langkah berikutnya
Untuk mengetahui informasi tentang mempromosikan hasil yang tidak diberi peringkat, lihat Mempromosikan jawaban yang tidak diberi peringkat.
Untuk mengetahui informasi tentang membatasi jumlah jawaban berperingkat dalam respons, lihat Membatasi jumlah jawaban dalam respons.
Untuk contoh C# yang menggunakan peringkat untuk menampilkan hasil, lihat tutorial peringkat C#.