Utilizar a classificação para apresentar os resultados da pesquisa de entidades
Aviso
A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.
Cada resposta de pesquisa de entidades inclui uma resposta RankingResponse que especifica como tem de apresentar os resultados da pesquisa devolvidos pela API de Pesquisa de Entidades do Bing. Os grupos de resposta de classificação resultam em conteúdo de pole, mainline e barra lateral. O resultado da pole é o resultado mais importante ou proeminente e deve ser apresentado primeiro. Se não apresentar os restantes resultados num formato tradicional de mainline e barra lateral, tem de fornecer ao conteúdo da linha principal uma maior visibilidade do que o conteúdo da barra lateral.
Dentro de cada grupo, a matriz Itens identifica a ordem em que o conteúdo tem de aparecer. Cada item fornece duas formas de identificar o resultado numa resposta.
| Campo | Descrição |
|---|---|
answerType e resultIndex |
answerType identifica a resposta (Entidade ou Local) e resultIndex identifica um resultado nessa resposta (por exemplo, uma entidade). O índice começa em 0. |
value |
value Contém um ID que corresponde ao ID de uma resposta ou um resultado na resposta. A resposta ou os resultados contêm o ID, mas não ambos. |
Utilizar o answerType e resultIndex é um processo de dois passos. Primeiro, utilize answerType para identificar a resposta que contém os resultados a apresentar. Em seguida, utilize resultIndex para indexar os resultados dessa resposta para obter o resultado a apresentar. (O answerType valor é o nome do campo no objeto SearchResponse .) Se for suposto apresentar todos os resultados da resposta em conjunto, o item de resposta da classificação não inclui o resultIndex campo.
Utilizar o ID requer que corresponda ao ID de classificação com o ID de uma resposta ou um dos respetivos resultados. Se um objeto de resposta incluir um id campo, apresente todos os resultados da resposta em conjunto. Por exemplo, se o Entities objeto incluir o id campo, apresente todos os artigos de entidades em conjunto. Se o Entities objeto não incluir o id campo, cada entidade contém um id campo e a resposta de classificação mistura as entidades com os resultados Casas.
Exemplo de resposta de classificação
Segue-se um exemplo de 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"
}
}
]
}
}
}
Com base nesta resposta de classificação, a barra lateral apresentaria os resultados de duas entidades relacionados com Jimi Horizontal.