Verwenden der Rangfolge zum Anzeigen von Ergebnissen der Entitätssuche
Warnung
Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.
Jedes Ergebnis einer Entitätssuche enthält eine RankingResponse-Antwort, die angibt, wie die von der Bing-Entitätssuche-API zurückgegebenen Suchergebnisse angezeigt werden müssen. Anhand der Rangfolgeantwort werden die Ergebnisse in Spitzenpositions-, Hauptbereichs- und Randleisteninhalte gruppiert. Das Spitzenpositionsergebnis ist das wichtigste oder hervorstechendste Ergebnis und sollte zuerst angezeigt werden. Wenn Sie die übrigen Ergebnisse nicht in einem herkömmlichen Hauptbereichs- und Randleistenformat anzeigen, müssen Sie dem Hauptbereichsinhalt höhere Sichtbarkeit als dem Randleisteninhalt zuweisen.
Innerhalb jeder Gruppe gibt das Items-Array die Reihenfolge an, in der die Inhalte angezeigt werden müssen. Jedes Element bietet zwei Möglichkeiten zur Angabe des Ergebnisses in einer Antwort.
| Feld | Beschreibung |
|---|---|
answerType und resultIndex |
answerType bezeichnet die Antwort (entweder eine Entität oder ein Ort) und resultIndex bezeichnet ein Ergebnis in dieser Antwort (z.B. eine Entität). Der Index beginnt bei 0. |
value |
value enthält eine ID, die entweder der ID einer Antwort oder eines Ergebnisses in der Antwort entspricht. Die ID ist entweder in der Antwort oder den Ergebnissen enthalten, jedoch nicht in beidem. |
Die Verwendung von answerType und resultIndex ist ein zweistufiger Prozess. Verwenden Sie zuerst answerType, um die Antwort anzugeben, in der die anzuzeigenden Ergebnisse enthalten sind. Verwenden Sie dann resultIndex zum Indizieren in die Ergebnisse dieser Antwort, um das anzuzeigende Ergebnis abzurufen. (Der Wert für answerType ist der Name des Felds im SearchResponse-Objekt.) Wenn alle Ergebnisse der Antwort zusammen angezeigt werden sollen, weist das Element der Rangfolgeantwort kein resultIndex-Feld auf.
Bei Verwendung der ID muss die Rangfolgen-ID mit der ID einer Antwort oder eines ihrer Ergebnisse übereinstimmen. Wenn ein Antwortobjekt ein id-Feld enthält, werden alle Ergebnisse der Antwort zusammen angezeigt. Enthält beispielsweise das Entities-Objekt das id-Feld, werden alle Entitätsartikel zusammen angezeigt. Wenn das Entities-Objekt das id-Feld nicht enthält, weist jede Entität ein id-Feld auf, und in der Rangfolgeantwort sind die Entitäten mit den Ergebnissen für Orte gemischt.
Beispiel einer Rangfolgeantwort
Nachfolgend sehen Sie ein Beispiel für 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"
}
}
]
}
}
}
Auf Grundlage dieser Rangfolgeantwort werden in der Randleiste die beiden Entitätsergebnisse im Zusammenhang mit Jimi Hendrix angezeigt.