Início Rápido: Chamar o ponto final da Pesquisa Personalizada do Bing com Python

Artigo
05/08/2020

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.

Utilize este início rápido para saber como pedir resultados de pesquisa à sua instância de Pesquisa Personalizada do Bing. Embora esta aplicação esteja escrita 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 para este exemplo está disponível no GitHub.

Pré-requisitos

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

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa Personalizada do Bing ao criar um dos seguintes recursos do Azure.

Recurso de Pesquisa Personalizada do Bing

Disponível através do portal do Azure até eliminar o recurso.
Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-Serviço

Disponível através do portal do Azure até eliminar o recurso.
Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Criar e inicializar a aplicação

Crie um novo ficheiro Python no seu IDE ou editor favorito e adicione as seguintes instruções de importação. Crie variáveis para a sua chave de subscrição, 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 um pedido de pesquisa

Construa o URL do pedido ao anexar o termo de pesquisa ao parâmetro de consulta e ao q= ID de configuração personalizado da instância de pesquisa para o customconfig= parâmetro. Separe os parâmetros com um esand (&). Pode utilizar o ponto final global no seguinte código ou utilizar o ponto final de subdomínio personalizado apresentado no portal do Azure do recurso.
```
url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
```
Envie o pedido para a instância de Pesquisa Personalizada do Bing e imprima os resultados da pesquisa devolvidos.
```
r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
print(r.text)
```

Passos seguintes

Criar uma aplicação Web de Pesquisa Personalizada

Partilhar via