Så här använder du rangordning för att visa API-resultat för webbsökning i Bing
Varning
Den 30 oktober 2020 flyttades Bing-sökning-API:erna från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.
Varje söksvar innehåller ett RankingResponse-svar som anger hur du måste visa sökresultaten. Rangordningssvaret grupperar resultat efter huvudinnehåll och sidofältsinnehåll för en traditionell sökresultatsida. Om du inte visar resultatet i ett traditionellt huvudlinje- och sidofältsformat måste du ge huvudlinjeinnehållet högre synlighet än sidopanelens innehåll.
I varje grupp (huvudlinje eller marginallist) identifierar matrisen Items den ordning som innehållet måste visas i. Varje objekt innehåller följande två sätt att identifiera resultatet i ett svar.
answerTypeochresultIndex– FältetanswerTypeidentifierar svaret (till exempel webbsida eller nyheter) ochresultIndexidentifierar ett resultat i svaret (till exempel en nyhetsartikel). Indexet är nollbaserat.value— Fältetvalueinnehåller ett ID som matchar ID:t för antingen ett svar eller ett resultat i svaret. Antingen innehåller svaret eller resultatet ID:t men inte båda.
Det är enklare att använda ID:t eftersom du bara behöver matcha rangordnings-ID:t med ID:t för ett svar eller ett av dess resultat. Om ett svarsobjekt innehåller ett id fält visar du alla svarsresultat tillsammans. Om objektet News till exempel innehåller id fältet visar du alla nyhetsartiklar tillsammans. Om objektet News inte innehåller id fältet innehåller varje nyhetsartikel ett id fält och rangordningssvaret blandar nyhetsartiklarna med resultaten från andra svar.
answerType Att använda och resultIndex är lite mer komplicerat. Du använder answerType för att identifiera svaret som innehåller de resultat som ska visas. Sedan använder resultIndex du för att indexeras genom svarets resultat för att få resultatet att visa. (Värdet answerType är namnet på fältet i SearchResponse-objektet .) Om du ska visa alla svarsresultat tillsammans inkluderar inte rangordningssvarsobjektet fältet resultIndex .
Exempel på rangordningssvar
Nedan visas ett exempel på RankingResponse. Eftersom webbsvaret inte innehåller något id fält skulle du visa alla webbsidor individuellt baserat på rangordningen (varje webbsida innehåller ett id fält). Och eftersom svaren på bilder, videor och relaterade sökningar innehåller id fältet skulle du visa resultatet av vart och ett av dessa svar tillsammans baserat på rangordningen.
{
"_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"
}
}]
}
}
}
Baserat på det här rangordningssvaret skulle huvudlinjen visa följande sökresultat:
- Resultatet på den första webbsidan
- Alla bilder
- Den andra och tredje webbsidans resultat
- Alla videor
- Den fjärde, femte och sjätte webbsidans resultat
Och sidopanelen skulle visa följande sökresultat:
- Alla relaterade sökningar
Nästa steg
Information om hur du höjer upp orankade resultat finns i Främja svar som inte är rankade.
Information om hur du begränsar antalet rankade svar i svaret finns i Begränsa antalet svar i svaret.
Ett C#-exempel som använder rangordning för att visa resultat finns i självstudien om C#-rangordning.