Jak pomocí řazení zobrazit výsledky rozhraní API Bingu pro vyhledávání na webu
Upozornění
30. října 2020 se rozhraní API Vyhledávání Bingu přesunula ze služeb Azure AI na Vyhledávání Bingu Services. Tato dokumentace je k dispozici pouze pro referenci. Aktualizovanou dokumentaci najdete v dokumentaci k rozhraní API bingu pro vyhledávání. Pokyny k vytváření nových prostředků Azure pro vyhledávání Bingem najdete v tématu Vytvoření prostředku Vyhledávání Bingu prostřednictvím Azure Marketplace.
Každá odpověď hledání obsahuje odpověď RankingResponse , která určuje, jak se mají zobrazit výsledky hledání. Odpověď na hodnocení seskupuje výsledky podle hlavního obsahu a obsahu bočního panelu pro tradiční stránku výsledků hledání. Pokud výsledky nezobrazíte v tradičním formátu hlavního řádku a bočního panelu, musíte obsahu hlavní linky poskytnout vyšší viditelnost než obsah bočního panelu.
V rámci každé skupiny (hlavního nebo bočního panelu) určuje pole Items pořadí, ve které se musí obsah zobrazit. Každá položka poskytuje následující dva způsoby, jak identifikovat výsledek v rámci odpovědi.
answerTypearesultIndex— PoleanswerTypeidentifikuje odpověď (například Webová stránka nebo Zprávy) aresultIndexidentifikuje výsledek v rámci odpovědi (například zpravodajský článek). Index je založený na nule.value— Polevalueobsahuje ID, které odpovídá ID odpovědi nebo výsledku v odpovědi. Odpověď nebo výsledky obsahují ID, ale ne obojí.
Použití ID je jednodušší, protože stačí shodovat ID pořadí s ID odpovědi nebo jedním z jeho výsledků. Pokud objekt odpovědi obsahuje id pole, zobrazte všechny výsledky odpovědi společně. Pokud News například objekt obsahuje id pole, zobrazte všechny příspěvky společně. News Pokud objekt neobsahuje id pole, pak každý článek obsahuje id pole a odpověď na hodnocení smíchá zpravodajské články s výsledky z jiných odpovědí.
answerType Použití a resultIndex je trochu složitější. Používáte answerType k identifikaci odpovědi, která obsahuje výsledky, které chcete zobrazit. Pak pomocí resultIndex indexujete výsledky odpovědi, abyste výsledek zobrazili. (Hodnota answerType je název pole v objektu SearchResponse .) Pokud chcete zobrazit všechny výsledky odpovědi společně, položka odpovědi na hodnocení pole neobsahuje resultIndex .
Příklad odpovědi řazení
Následující příklad ukazuje RankingResponse. Vzhledem k tomu, že webová odpověď neobsahuje id pole, zobrazí se všechny webové stránky jednotlivě na základě pořadí (každá webová stránka obsahuje pole id ). A protože obrázky, videa a odpovědi souvisejícího hledání obsahují id pole, zobrazí se výsledky každé z těchto odpovědí společně na základě pořadí.
{
"_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"
}
}]
}
}
}
Na základě této odpovědi na hodnocení by hlavní řádek zobrazil následující výsledky hledání:
- První výsledek webové stránky
- Všechny obrázky
- Výsledky druhé a třetí webové stránky
- Všechna videa
- Výsledky 4., 5. a 6. webové stránky
Na bočním panelu se zobrazí následující výsledky hledání:
- Všechna související hledání
Další kroky
Informace o povýšení výsledků bez pořadí najdete v tématu Zvýšení úrovně odpovědí, které nejsou seřazené.
Informace o omezení počtu seřazených odpovědí v odpovědi najdete v tématu Omezení počtu odpovědí v odpovědi.
Příklad jazyka C#, který k zobrazení výsledků používá řazení, najdete v kurzu řazení v jazyce C#.