Volání a odpovědi: svůj první dotaz vyhledávání webové služby Bing v PythonuCall and response: your first Bing Web Search query in Python

Rozhraní API služby Bing webové Search poskytuje podobné Bing.com/Search vrácením, že výsledky hledání, které určuje Bing jsou relevantní pro dotaz uživatele.The Bing Web Search API provides an experience similar to Bing.com/Search by returning search results that Bing determines are relevant to the user's query. Výsledky mohou zahrnovat webové stránky, obrázků, videí, zprávy a entitami, spolu s související vyhledávací dotazy, pravopisu, časových pásem, převod jednotek, překladů a výpočty.The results may include Web pages, images, videos, news, and entities, along with related search queries, spelling corrections, time zones, unit conversion, translations, and calculations. Typy výsledků, které máte jsou založené na jejich významu a úroveň rozhraní API pro vyhledávání Bingu které odebíráte.The kinds of results you get are based on their relevance and the tier of the Bing Search APIs to which you subscribe.

Odkazovat referenční dokumentace rozhraní API technické podrobnosti o rozhraní API.Refer to the API reference for technical details about the APIs.

V tomto příkladu můžete spustit jako poznámkového bloku Jupyter na MyBinder kliknutím na spuštění vazač oznámení:You can run this example as a Jupyter notebook on MyBinder by clicking on the launch Binder badge:

VazačBinder

PožadavkyPrerequisites

Musíte mít kognitivní rozhraní API služby účet s rozhraní API pro Bing vyhledávání.You must have a Cognitive Services API account with Bing Search APIs. Bezplatnou zkušební verzi stačí pro tento rychlý start.The free trial is sufficient for this quickstart. Je nutné přístupový klíč zadaný při aktivaci bezplatné zkušební verze, nebo může použít klíč placené předplatné z řídicího panelu Azure.You need the access key provided when you activate your free trial, or you may use a paid subscription key from your Azure dashboard.

Spuštění PrůvodceRunning the walkthrough

Nastavit subscription_key k vašemu klíči rozhraní API pro službu Bing rozhraní API.Set subscription_key to your API key for the Bing API service.

subscription_key = None
assert subscription_key

Dále ověřte, zda search_url koncový bod není správný.Next, verify that the search_url endpoint is correct. Při psaní tohoto textu pouze jeden koncový bod se použije Bing vyhledávání rozhraní API.At this writing, only one endpoint is used for Bing search APIs. Pokud dojde k chybám ověřování, zkontrolujte tuto hodnotu na koncový bod hledání Bing v řídicím panelu Azure.If you encounter authorization errors, double-check this value against the Bing search endpoint in your Azure dashboard.

search_url = "https://api.cognitive.microsoft.com/bing/v7.0/search"

Nastavit search_term dotazu Bing kognitivní služeb společnosti Microsoft.Set search_term to query Bing for Microsoft Cognitive Services.

search_term = "Microsoft Cognitive Services"

Následující blok používá requests knihovny v Pythonu volání rozhraní API pro vyhledávání Bing a vrátí výsledky jako objekt JSON.The following block uses the requests library in Python to call out to the Bing search APIs and return the results as a JSON object. Pozorovat, že jsme předat klíč rozhraní API prostřednictvím headers slovníku a hledání termín prostřednictvím params slovníku.Observe that we pass in the API key via the headers dictionary and the search term via the params dictionary. Pokud chcete zobrazit úplný seznam možností, které lze použít pro filtrování výsledků hledání, naleznete REST API dokumentaci.To see the full list of options that can be used to filter search results, refer to the REST API documentation.

import requests

headers = {"Ocp-Apim-Subscription-Key" : subscription_key}
params  = {"q": search_term, "textDecorations":True, "textFormat":"HTML"}
response = requests.get(search_url, headers=headers, params=params)
response.raise_for_status()
search_results = response.json()

search_results Objekt obsahuje výsledky hledání společně s bohatou metadata, například související dotazy a stránky.The search_results object contains the search results along with rich metadata such as related queries and pages. Následující řádky kódu formátu hlavní stránky vrácených dotazem.The following lines of code format the top pages returned by the query.

from IPython.display import HTML

rows = "\n".join(["""<tr>
                       <td><a href=\"{0}\">{1}</a></td>
                       <td>{2}</td>
                     </tr>""".format(v["url"],v["name"],v["snippet"]) \
                  for v in search_results["webPages"]["value"]])
HTML("<table>{0}</table>".format(rows))

Další postupNext steps

Další informace najdete v tématechSee also

Hledání webové služby Bing – přehledBing Web Search overview
VyzkoušetTry it
Získat bezplatnou zkušební verzi přístupový klíč referenční dokumentace rozhraní API vyhledávání webové služby BingGet a free trial access key Bing Web Search API reference