Início Rápido: Chamar o endpoint de Pesquisa Personalizada do Bing com Python

Artigo
05/08/2020

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram transferidas 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 dodo Azure Marketplace.

Use este início rápido para saber como solicitar resultados da pesquisa de sua instância de Pesquisa Personalizada do Bing. Embora esse aplicativo seja escrito em Python, a API de Pesquisa Personalizada do Bing é um serviço Web RESTful compatível com a maioria das linguagens de programação. O código-fonte deste exemplo está disponível no GitHub.

Pré-requisitos

Uma instância de Pesquisa Personalizada do Bing. Para obter mais informações, consulte Início Rápido: Criar sua primeira instância de Pesquisa Personalizada do Bing.
Python 2.x ou 3.x.

Criar um recurso do Azure

Comece a usar a API de Pesquisa Personalizada do Bing criando um dos seguintes recursos do Azure.

recurso de Pesquisa Personalizada do Bing

Disponível por meio do portal do Azure até que você exclua o recurso.
Use o plano de preços gratuito para experimentar o serviço, e depois mude para um plano pago para fins de produção.

recurso multisserviço

Disponível por meio do portal do Azure até que você exclua o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos, em vários serviços de IA do Azure.

Criar e inicializar o aplicativo

Crie um novo arquivo Python em seu IDE ou editor favorito e adicione as instruções de importação a seguir. Crie variáveis para sua chave de assinatura, ID de configuração personalizada e termo de pesquisa.
```
import json
import requests

subscriptionKey = "YOUR-SUBSCRIPTION-KEY"
customConfigId = "YOUR-CUSTOM-CONFIG-ID"
searchTerm = "microsoft"
```

Enviar e receber uma solicitação de pesquisa

Construa a URL da solicitação acrescentando seu termo de pesquisa ao parâmetro de consulta q= e a ID de configuração personalizada da instância de pesquisa ao parâmetro customconfig=. Separe os parâmetros com um e comercial (&). Você pode usar o endpoint global no código a seguir ou usar o endpoint do subdomínio personalizado exibido no portal do Azure para seu recurso.
```
url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
```
Envie a solicitação para sua instância de Pesquisa Personalizada do Bing e imprima os resultados da pesquisa retornados.
```
r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
print(r.text)
```

Próximas etapas

criar um aplicativo Web de Pesquisa Personalizada

Compartilhar via