Jak używać klasyfikacji do wyświetlania wyników interfejsu API wyszukiwania w Sieci Web Bing
Ostrzeżenie
30 października 2020 r. interfejsy API Wyszukiwanie Bing zostały przeniesione z usług Azure AI do usług Wyszukiwanie Bing Services. Ta dokumentacja jest udostępniana tylko do celów referencyjnych. Aby uzyskać zaktualizowaną dokumentację, zobacz dokumentację interfejsu API wyszukiwania Bing. Aby uzyskać instrukcje dotyczące tworzenia nowych zasobów platformy Azure na potrzeby wyszukiwania Bing, zobacz Tworzenie zasobu Wyszukiwanie Bing za pośrednictwem Azure Marketplace.
Każda odpowiedź wyszukiwania zawiera odpowiedź RankingResponse określającą sposób wyświetlania wyników wyszukiwania. Klasyfikacja grup odpowiedzi powoduje wyniki według zawartości głównej i zawartości paska bocznego dla tradycyjnej strony wyników wyszukiwania. Jeśli wyniki nie są wyświetlane w tradycyjnym formacie linii głównej i paska bocznego, musisz podać zawartość linii głównej większą widoczność niż zawartość paska bocznego.
W każdej grupie (linia główna lub pasek boczny) tablica Items identyfikuje kolejność wyświetlania zawartości. Każdy element udostępnia następujące dwa sposoby identyfikowania wyniku w odpowiedzi.
answerTypeiresultIndex—answerTypepole identyfikuje odpowiedź (na przykład stronę internetową lub wiadomości) iresultIndexidentyfikuje wynik w odpowiedzi (na przykład artykuł z wiadomościami). Indeks jest oparty na zerze.valuevalue— Pole zawiera identyfikator zgodny z identyfikatorem odpowiedzi lub wyniku w odpowiedzi. Odpowiedź lub wyniki zawierają identyfikator, ale nie oba.
Użycie identyfikatora jest prostsze do użycia, ponieważ wystarczy dopasować identyfikator klasyfikacji do identyfikatora odpowiedzi lub jednego z wyników. Jeśli obiekt odpowiedzi zawiera id pole, wyświetl wszystkie wyniki odpowiedzi razem. Jeśli na przykład News obiekt zawiera id pole, wyświetl razem wszystkie artykuły z wiadomościami.
News Jeśli obiekt nie zawiera id pola, każdy artykuł z wiadomościami zawiera id pole, a odpowiedź klasyfikacji łączy artykuły z wiadomościami z wynikami z innych odpowiedzi.
Korzystanie z elementu answerType i resultIndex jest nieco bardziej skomplikowane.
answerType Służy do identyfikowania odpowiedzi zawierającej wyniki do wyświetlenia. Następnie użyj polecenia resultIndex , aby zaindeksować wyniki odpowiedzi, aby uzyskać wynik do wyświetlenia. (Wartość answerType jest nazwą pola w obiekcie SearchResponse ). Jeśli chcesz wyświetlić wszystkie wyniki odpowiedzi razem, element odpowiedzi klasyfikacji nie zawiera resultIndex pola.
Przykład odpowiedzi klasyfikacji
Poniżej przedstawiono przykładową pozycję RankingResponse. Ponieważ odpowiedź w sieci Web nie zawiera id pola, wszystkie strony internetowe będą wyświetlane indywidualnie na podstawie klasyfikacji (każda strona internetowa zawiera id pole). Ponieważ obrazy, filmy wideo i powiązane odpowiedzi na wyszukiwania zawierają id pole, wyniki każdej z tych odpowiedzi można wyświetlić razem na podstawie klasyfikacji.
{
"_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 podstawie tej odpowiedzi klasyfikacji główna linia będzie wyświetlać następujące wyniki wyszukiwania:
- Pierwszy wynik strony internetowej
- Wszystkie obrazy
- Wyniki drugiej i trzeciej strony internetowej
- Wszystkie filmy wideo
- Wyniki 4, 5 i 6 strony internetowej
Na pasku bocznym będą wyświetlane następujące wyniki wyszukiwania:
- Wszystkie powiązane wyszukiwania
Następne kroki
Aby uzyskać informacje na temat promowania nies rankingu wyników, zobacz Promowanie odpowiedzi, które nie są klasyfikowane.
Aby uzyskać informacje na temat ograniczania liczby sklasyfikowanych odpowiedzi w odpowiedzi, zobacz Ograniczanie liczby odpowiedzi w odpowiedzi.
Aby zapoznać się z przykładem języka C#, który używa klasyfikacji do wyświetlania wyników, zobacz samouczek klasyfikacji języka C#.