Hur du använder rangordning för att visa resultat för webbsökning i BingHow to use ranking to display Bing Web Search API results

Varje sökning svaret innehåller en RankingResponse svar som anger hur du måste visa sökresultatet.Each search response includes a RankingResponse answer, that specifies how you must display the search results. Rangordning svaret grupperar resultaten av mainline innehållet och sidopanelen innehåll för en traditionell sökresultat sidan.The ranking response groups results by mainline content and sidebar content for a traditional search results page. Om du inte visa resultatet i en traditionell likriktade och sidopanelen format, måste du ange likriktade innehåll högre synlighet än sidopanelen innehållet.If you do not display the results in a traditional mainline and sidebar format, you must provide the mainline content higher visibility than the sidebar content.

Inom varje grupp (mainline eller sidopanelen), objekt matris identifierar den ordning som innehållet måste finnas i.Within each group (mainline or sidebar), the Items array identifies the order that the content must appear in. Varje objekt innehåller följande två sätt att identifiera resultatet i ett svar.Each item provides the following two ways to identify the result within an answer.

  • answerType och resultIndex – den answerType fältet identifierar svar (till exempel webbsidan eller nyheter) och resultIndex identifierar ett resultat i svaret (till exempel nyhetsartikel).answerType and resultIndex — The answerType field identifies the answer (for example, Webpage or News) and resultIndex identifies a result within the answer (for example, a news article). Indexet är nollbaserat.The index is zero based.

  • value – Det value fält innehåller ett ID som matchar ID: T för ett svar eller ett resultat i svaret.value — The value field contains an ID that matches the ID of either an answer or a result within the answer. Svaret eller resultatet innehålla ID men inte båda.Either the answer or the results contain the ID but not both.

Med hjälp av ID är enklare att använda eftersom du bara behöver matcha rangordning ID med ID: T för ett svar eller ett av resultaten.Using the ID is simpler to use because you only need to match the ranking ID with the ID of an answer or one of its results. Om ett svar-objekt innehåller en id fältet, visa resultat som svaret finns tillsammans.If an answer object includes an id field, display all the answer's results together. Till exempel om den News objektet innehåller de id fältet, visa alla nyhetsartiklar tillsammans.For example, if the News object includes the id field, display all the news articles together. Om den News objekt omfattar inte den id fältet och sedan varje nyhetsartikel innehåller en id fältet och svaret rangordning blandas i nyhetsartiklar med resultaten från andra svar.If the News object does not include the id field, then each news article contains an id field and the ranking response mixes the news articles with the results from other answers.

Med hjälp av den answerType och resultIndex är lite mer komplicerad.Using the answerType and resultIndex is a little more complicated. Du använder answerType att identifiera det svar som innehåller resultatet ska visas.You use answerType to identify the answer that contains the results to display. Sedan använder du resultIndex till index via svarets resultat att få resultat att visa.Then, you use resultIndex to index through the answer's results to get the result to display. (Den answerType värdet är namnet på fältet i den SearchResponse objekt.) Om du ska visa resultat som svaret finns tillsammans rangordning svaret objekt inte innehåller den resultIndex fält.(The answerType value is the name of the field in the SearchResponse object.) If you're supposed to display all the answer's results together, the ranking response item doesn't include the resultIndex field.

Rangordning svar-exempelRanking response example

Följande visar ett exempel RankingResponse.The following shows an example RankingResponse. Web-svaret inte innehåller en id fält, visa alla webbsidor individuellt baserat på rangordning (varje webbsidan innehåller en id fältet).Because the Web answer does not include an id field, you'd display all webpages individually based on the ranking (each webpage includes an id field). Och eftersom de bilder, videoklipp och relaterade sökningar svar omfattar den id fält, visa resultatet av var och en av dessa tillsammans svar baserat på rangordning.And because the images, videos, and related searches answers do include the id field, you'd display the results of each of those answers together based on the ranking.

{  
    "_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å den här rangordning svar, visar det likriktade följande sökresultat:Based on this ranking response, the mainline would display the following search results:

  • Det första resultatet för webbsidaThe first webpage result
  • Alla avbildningarAll the images
  • Andra och tredje webbsidan resultatenThe second and third webpage results
  • Alla videorAll the videos
  • 4, 5 och 6 webbsidan resultatenThe 4th, 5th, and 6th webpage results

Och sidopanelen skulle visa följande sökresultat:And the sidebar would display the following search results:

  • Alla relaterade sökningarAll the related searches

Nästa stegNext steps

Information om hur du lyfter unranked resultat finns i befordrar svar som inte rangordnas.For information about promoting unranked results, see Promoting answers that are not ranked.

Information om hur du begränsar antalet rankad svar i svaret finns i begränsningen av antalet svar i svaret.For information about limiting the number of ranked answers in the response, see Limiting the number of answers in the response.

En C# exempel som använder rangordning för att visa resultat finns i rangordning självstudie i C#.For a C# example that uses ranking to display results, see C# ranking tutorial.