Sugestão de termos de consulta
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.
Normalmente, você chamará a API de Sugestão Automática do Bing sempre que um usuário digitar um novo caractere na caixa de pesquisa do aplicativo. A integridade da cadeia de caracteres de consulta afeta a relevância dos termos de consulta sugeridos que a API retorna. Quanto mais completa a cadeia de caracteres de consulta, mais relevante é a lista de termos de consulta sugeridos. Por exemplo, as sugestões que a API poderá retornar para s provavelmente são menos relevantes do que as consultas retornadas para sailing dinghies.
Solicitação de exemplo
O exemplo a seguir mostra uma solicitação que retorna as cadeias de caracteres de consulta sugeridas para navegar. Lembre-se de codificar a URL do termo de consulta parcial do usuário quando você definir o parâmetro de consulta q. Por exemplo, se o usuário inserir sailing les, defina q como sailing+les ou sailing%20les.
GET https://api.cognitive.microsoft.com/bing/v7.0/suggestions?q=sail&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
A resposta a seguir contém uma lista de objetos de SearchAction que contêm os termos de consulta sugeridos.
{
"url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
"displayText" : "sailing lessons seattle",
"query" : "sailing lessons seattle",
"searchKind" : "WebSearch"
}, ...
Usando os termos de consulta sugeridos
Cada sugestão inclui um campo displayText, query e url. O campo displayText contém a consulta sugerida que você usa para preencher a lista suspensa de sua caixa de pesquisa. Exiba todas as sugestões incluídas na resposta e na ordem determinada.
O exemplo a seguir mostra uma caixa de pesquisa suspensa com os termos de consulta sugeridos pela API de Sugestão Automática do Bing.
Se o usuário selecionar uma consulta sugerida na lista suspensa, você poderá usar o termo de consulta no campo query para chamar a API de Pesquisa na Web do Bing e exibir os resultados por conta própria. Ou você pode usar a URL no campo url para enviar o usuário à página de resultados da pesquisa do Bing.