使用排名來顯示實體搜尋結果
警告
2020 年 10 月 30 日，Bing 搜尋 API 已從 Azure AI 服務移至Bing 搜尋服務。 本文件僅供參考之用。 如需更新的文件，請參閱 Bing 搜尋 API 文件。 如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。
每個實體搜尋回應都包含 RankingResponse 回應，可指定您必須以何種方式顯示 Bing 實體搜尋 API 所傳回的搜尋結果。 排名回應會將結果分組為 pole、mainline 和 sidebar 內容。 pole 結果是最重要或顯著的結果，應該優先顯示。 如果您未以傳統 mainline 和 sidebar 格式顯示其餘結果，您必須提供比 sidebar 內容更高的 mainline 內容可見度。
在每個群組內，項目陣列會識別內容必須出現的順序。 每個項目會提供兩種方式來識別回應內的結果。
| 欄位 | 描述 |
|---|---|
answerType 和 resultIndex |
answerType 會識別回應 (實體或位置)，而 resultIndex 會識別回應內的結果 (例如一個實體)。 索引從 0 開始。 |
value |
value 包含的識別碼會符合回應或回應內結果的識別碼。 回應或結果其中一個 (而非兩者) 會包含識別碼。 |
使用 answerType 和 resultIndex 是一個兩步驟程序。 先使用 answerType 來識別哪個回應包含要顯示的結果。 然後使用 resultIndex 為回應的結果編製索引，以顯示結果。 (answerType 值是 SearchResponse 物件中欄位的名稱)。如果您應該一起顯示所有答案的結果，則排名回應項目就不會包括 resultIndex 欄位。
使用識別碼需要您比對排名識別碼與回應或其中一個結果的識別碼。 如果回應物件包含 id 欄位，則會同時顯示回應的所有結果。 例如，如果 Entities 物件包含 id 欄位，則會同時顯示所有實體發行項。 如果 Entities 物件不包含 id 欄位，則每個實體會包含 id 欄位，且排名回應會混合實體與位置結果。
排名回應範例
以下顯示範例 RankingResponse。
{
"_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"
}
}
]
}
}
}
根據此排名回應，sidebar 會顯示與 Jimi Hendrix 相關的兩個實體結果。