共用方式為


快速入門:使用 Python 呼叫您的 Bing 自訂搜尋端點

警告

在 2020 年 10 月 30 日,Bing 搜尋 API 已從 Azure AI 服務移至 Bing 搜尋 服務。 本文件僅供參考之用。 如需更新的文件,請參閱 Bing 搜尋 API 文件。 如需針對 Bing 搜尋建立新 Azure 資源的指示,請參閱透過 Azure Marketplace 建立 Bing 搜尋資源

使用本快速入門了解如何要求 Bing 自訂搜尋執行個體所產生的搜尋結果。 雖然此應用程式是以 Python 撰寫的,但 Bing 自訂搜尋 API 是一種與大多數程式設計語言都相容的 RESTful Web 服務。 GitHub 上有此範例的原始程式碼。

Prerequisites

建立 Azure 資源

藉由建立下列其中一項 Azure 資源,開始使用 Bing 自訂搜尋 API。

Bing 自訂搜尋資源

  • 您可以透過 Azure 入口網站取得該資源,直到將其刪除為止。
  • 使用免費定價層來試用服務,之後可升級至付費層以用於實際執行環境。

多服務資源

  • 您可以透過 Azure 入口網站取得該資源,直到將其刪除為止。
  • 針對您的應用程式,跨多個 Azure AI 服務使用相同的金鑰和端點。

建立應用程式並將其初始化

  • 在您慣用的 IDE 或編輯器中建立新的 Python 專案,以及新增下列匯入陳述式。 為您的訂用帳戶金鑰、自訂設定識別碼和搜尋字詞建立變數。

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

傳送及接收搜尋要求

  1. 將搜尋字詞附加至 q= 查詢參數,並將搜尋執行個體的自訂設定識別碼附加至 customconfig= 參數,以建構要求 URL。 請以 & 符號分隔參數。 您可以使用下列程式碼中的全域端點,或使用 Azure 入口網站中針對您的資源顯示的自訂子網域端點。

    url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
    
  2. 將要求傳送至 Bing 自訂搜尋執行個體,並列印傳回的搜尋結果。

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

後續步驟