Usar a classificação para exibir os resultados da pesquisa da entidade
Aviso
Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte 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, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.
Cada resposta da pesquisa de entidade inclui uma resposta RankingResponse, que especifica como você deve exibir os resultados da pesquisa retornados pela API de Pesquisa de Entidade do Bing. A resposta de classificação agrupa os resultados no polo, principal e o conteúdo da barra lateral. O resultado de polo é o resultado mais importante ou proeminente e deve ser exibido primeiro. Se você não exibir os resultados restantes em um formato de barra lateral e principal tradicional, você deve fornecer a visibilidade de maior conteúdo principal que o conteúdo da barra lateral.
Em cada grupo, a matriz de Itens identifica a ordem na qual o conteúdo deve aparecer. Cada item fornece duas maneiras para identificar o resultado em uma resposta.
| Campo | Descrição |
|---|---|
answerType e resultIndex |
answerType identifica a resposta (entidade ou local) e resultIndex identifica um resultado dentro dessa resposta (por exemplo, uma entidade). O índice começa em 0. |
value |
value contém uma ID que corresponde à ID de uma resposta ou um resultado dentro da resposta. A resposta ou os resultados contêm a ID, mas não ambos. |
Usar o answerType e resultIndex é um processo de duas etapas. Primeiro, use answerType para identificar a resposta que contém os resultados a serem exibidos. Em seguida, use resultIndex para indexar os resultados dessa resposta para obter o resultado a exibir. (O valor answerType é o nome do campo no objeto SearchResponse.) Se quiser exibir todos os resultados da resposta juntos, o item de resposta de classificação não incluirá o campo resultIndex.
Usar a ID requer correspondência da ID de classificação com a ID de uma resposta ou um dos seus resultados. Se um objeto de resposta inclui um campo id, exiba todos os resultados da resposta juntos. Por exemplo, se o objeto Entities inclui o campo id, exibir todos os artigos de entidades juntos. Se o objeto Entities não inclui o campo id, em seguida, cada entidade contém um campo id e a resposta de classificação mescla as entidades com os resultados de locais.
Exemplo de resposta de classificação
A seguir é mostrado 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 nessa resposta de classificação, a barra lateral exibirá os resultados de duas entidades relacionados ao Jimi Hendrix.