Compartilhar via


Chame sua instância de Pesquisa Personalizada do Bing no Portal

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.

Depois de configurar sua experiência de pesquisa personalizada, você pode testar a partir do portal de Pesquisa Personalizada do Bing.

captura de tela do portal da pesquisa personalizada do Bing

Criar uma consulta de pesquisa

Depois de entrar no portal da Pesquisa Personalizada do Bing, selecione sua instância de pesquisa e clique na guia Produção. Em Pontos de extremidade, selecione um ponto de extremidade de API (por exemplo, API Web). Sua assinatura determina quais pontos de extremidade são mostrados.

Para criar uma consulta de pesquisa, insira os valores de parâmetro para seu ponto de extremidade. Observe que os parâmetros exibidos no portal podem mudar dependendo do ponto de extremidade queescolher. Consulte a Referência da API da Pesquisa Personalizada para saber mais. Para alterar a assinatura que sua instância de pesquisa usa, adicione a chave de assinatura apropriada e atualize os parâmetros de mercado e/ou idioma apropriados.

Alguns parâmetros importantes estão abaixo:

Parâmetro Descrição
Consulta O termo de pesquisa a ser pesquisado. Disponível somente para pontos de extremidade da Web, de Imagem, de Vídeo e da Sugestão Automática
ID de configuração personalizada O ID de configuração da instância selecionada de Pesquisa Personalizada. Este campo é somente leitura.
Market O mercado que os resultados serão originados. Disponível somente para Web, Imagem, Vídeo e ponto de extremidade da Interface do Usuário Hospedada.
Chave de Assinatura A chave de assinatura para o teste. Selecione uma chave na lista suspensa ou inserir uma manualmente.

Clicar em Parâmetros adicionais revela os seguintes parâmetros:

Parâmetro Descrição
Salvar pesquisa Um filtro usado para filtrar as páginas da Web para conteúdo adulto. Disponível somente para Web, Imagem, Vídeo e ponto de extremidade da Interface do Usuário Hospedada. Observe que a Pesquisa Personalizada de Vídeo do Bing suporta apenas dois valores: moderate e strict.
Linguagens de Interface do Usuário A linguagem a ser usada para cadeias de caracteres de interface do usuário. Por exemplo, se você habilitar imagens e vídeos na interface do usuário hospedada, as guias Imagem e Vídeo usarão o idioma especificado.
Contagem O número de resultados da pesquisa a ser retornado na resposta. Disponível somente para pontos de extremidade da Web, de Imagem e de Vídeo.
Deslocamento O número de resultados da pesquisa a ignorar antes de retornar resultados. Disponível somente para pontos de extremidade da Web, de Imagem e de Vídeo.

Depois de especificar todas as opções necessárias, clique em Chamar para exibir a resposta JSON no painel direito. Se você selecionar o ponto de extremidade da Interface do Usuário Hospedada, poderá testar a experiência de pesquisa no painel inferior.

Alterar sua assinatura da Pesquisa Personalizada do Bing

Você pode alterar a assinatura associada à sua instância da Pesquisa Personalizada do Bing sem criar uma nova instância. Para que as chamadas à API sejam enviadas e cobradas para uma nova assinatura, crie um novo recurso da Pesquisa Personalizada do Bing no portal do Azure. Use a nova chave de assinatura em suas solicitações de API, juntamente com a ID de configuração personalizada da instância.

Próximas etapas