Dela via


Snabbstart: Anropa slutpunkten för anpassad Bing-sökning med Python

Varning

Den 30 oktober 2020 flyttades Bing-sökning-API:erna från Azure AI-tjänster till Bing-sökning Services. Den här dokumentationen tillhandahålls endast som referens. Uppdaterad dokumentation finns i dokumentationen för API:et för Bing-sökning. Anvisningar om hur du skapar nya Azure-resurser för Bing-sökning finns i Skapa en Bing-sökning resurs via Azure Marketplace.

Använd den här snabbstarten om du vill lära dig hur du begär sökresultat från din instans av anpassad Bing-sökning. Även om det här programmet är skrivet i Python är API:et för anpassad sökning i Bing en RESTful-webbtjänst som är kompatibel med de flesta programmeringsspråk. Källkoden för det här exemplet finns på GitHub.

Förutsättningar

Skapa en Azure-resurs

Börja använda API:et för anpassad Bing-sökning genom att skapa någon av följande Azure-resurser.

Resurs för anpassad Bing-sökning

  • Tillgänglig via Azure Portal tills du tar bort resursen.
  • Använd den kostnadsfria prisnivån för att prova tjänsten och uppgradera senare till en betald nivå för produktion.

Resurs för flera tjänster

  • Tillgänglig via Azure Portal tills du tar bort resursen.
  • Använd samma nyckel och slutpunkt för dina program i flera Azure AI-tjänster.

Skapa och initiera appen

  • Skapa en ny Python-fil i valfri IDE eller redigeringsprogram och lägg till följande importinstruktioner. Skapa variabler för din prenumerationsnyckel, anpassat konfigurations-ID och sökterm.

    import json
    import requests
    
    subscriptionKey = "YOUR-SUBSCRIPTION-KEY"
    customConfigId = "YOUR-CUSTOM-CONFIG-ID"
    searchTerm = "microsoft"
    

Skicka och ta emot en sökbegäran

  1. Skapa begärande-URL:en genom att lägga till söktermen i q= frågeparametern och sökinstansens anpassade konfigurations-ID till parametern customconfig= . Avgränsa parametrarna med ett et-tecken (&). Du kan använda den globala slutpunkten i följande kod eller använda den anpassade underdomänslutpunkten som visas i Azure Portal för resursen.

    url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
    
  2. Skicka begäran till din instans av anpassad Bing-sökning och skriv ut de returnerade sökresultaten.

    r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
    print(r.text)
    

Nästa steg