Varlık arama sonuçlarını görüntülemek için derecelendirmeyi kullanma

Uyarı

30 Ekim 2020'de Bing Arama API'leri Azure yapay zeka hizmetlerinden Bing Arama Hizmetlerine taşındı. Bu belgeler yalnızca başvuru için sağlanır. Güncelleştirilmiş belgeler için Bing arama API'sinin belgelerine bakın. Bing araması için yeni Azure kaynakları oluşturma yönergeleri için bkz. Azure Market aracılığıyla Bing Arama kaynağı oluşturma.

Her varlık arama yanıtı, Bing Varlık Arama API'sinin döndürdiği arama sonuçlarını nasıl görüntülemeniz gerektiğini belirten bir RankingResponse yanıtı içerir. Derecelendirme yanıtı sonuçları kutup, ana hat ve kenar çubuğu içeriğine göre gruplandırıyor. Kutup sonucu en önemli veya göze çarpan sonuçdur ve önce görüntülenmelidir. Kalan sonuçları geleneksel bir ana hat ve kenar çubuğu biçiminde görüntülemezseniz, ana çizgi içeriğini kenar çubuğu içeriğinden daha yüksek görünürlük sağlamanız gerekir.

Her grubun içinde Öğeler dizisi, içeriğin gösterilmesi gereken sırayı tanımlar. Her öğe, yanıtın içindeki sonucu tanımlamak için iki yol sağlar.

Alan Açıklama
answerType ve resultIndex answerType yanıtı (Varlık veya Yer) tanımlar ve resultIndex bu yanıttaki bir sonucu (örneğin, bir varlık) tanımlar. Dizin 0'da başlar.
value value Yanıtın veya yanıtın içindeki sonucun kimliğiyle eşleşen bir kimlik içerir. Yanıt veya sonuçlar kimliği içerir ancak ikisini birden içermez.

ve resultIndex kullanmak answerType iki adımlı bir işlemdir. İlk olarak, görüntülenecek sonuçları içeren yanıtı tanımlamak için kullanın answerType . Ardından sonucun görüntülenmesini sağlamak için bu yanıtın sonuçlarını dizine almak için komutunu kullanın resultIndex . answerType(Değer, SearchResponse nesnesindeki alanın adıdır.) Yanıtın tüm sonuçlarını birlikte görüntülemeniz gerekiyorsa, derecelendirme yanıt öğesi alanı içermezresultIndex.

Kimliğin kullanılması, derecelendirme kimliğini bir yanıtın kimliğiyle veya sonuçlarından biriyle eşleştirmenizi gerektirir. Yanıt nesnesi bir id alan içeriyorsa, yanıtın tüm sonuçlarını birlikte görüntüleyin. Örneğin, Entities nesne alanı içeriyorsa id tüm varlık makalelerini birlikte görüntüleyin. Entities Nesne alanı içermiyorsaid, her varlık bir id alan içerir ve derecelendirme yanıtı varlıkları Yerler sonuçlarıyla karıştırır.

Derecelendirme yanıtı örneği

Aşağıda örnek bir RankingResponse gösterilmektedir.

{
  "_type": "SearchResponse",
  "queryContext": {
    "originalQuery": "Jimi Hendrix"
  },
  "entities": { ... },
  "rankingResponse": {
    "sidebar": {
      "items": [
        {
          "answerType": "Entities",
          "resultIndex": 0,
          "value": {
            "id": "https://www.bingapis.com/api/v7/#Entities.0"
          }
        },
        {
          "answerType": "Entities",
          "resultIndex": 1,
          "value": {
            "id": "https://www.bingapis.com/api/v7/#Entities.1"
          }
        }
      ]
    }
  }
}

Bu sıralama yanıtına bağlı olarak kenar çubuğunda Jimi Hendrix ile ilgili iki varlık sonucu görüntülenir.

Sonraki adımlar