警告
在 2020 年 10 月 30 日,Bing 搜尋 API 從 Azure AI 服務移至 Bing 搜尋服務。 本檔僅供參考。 如需更新的檔案,請參閱 Bing 搜尋 API 檔案。 如需建立 Bing 搜尋新 Azure 資源的指示,請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。
使用此快速入門瞭解如何向 Bing 自定義搜尋實例要求搜尋結果。 雖然此應用程式是以 JavaScript 撰寫,但 Bing 自定義搜尋 API 是與大部分程式設計語言相容的 RESTful Web 服務。 此範例的原始程式碼可在 GitHub 取得。
先決條件
Bing 自定義搜尋實例。 如需詳細資訊,請參閱 快速入門:建立您的第一個 Bing 自定義搜尋實例。
建立 Azure 資源
建立下列其中一個 Azure 資源,以開始使用 Bing 自定義搜尋 API。
Bing 自定義搜尋資源
- 可透過 Azure 入口網站取得,直到您刪除資源為止。
- 使用免費定價層來試用服務,稍後升級至生產環境的付費層。
多服務資源
- 可透過 Azure 入口網站取得,直到您刪除資源為止。
- 針對您的應用程式,跨多個 Azure AI 服務使用相同的金鑰和端點。
建立和初始化應用程式
在慣用的 IDE 或編輯器中建立新的 JavaScript 檔案,並為要求連結庫新增
require()語句。 為您的訂用帳戶金鑰、自定義組態標識碼和搜尋字詞建立變數。var request = require("request"); var subscriptionKey = 'YOUR-SUBSCRIPTION-KEY'; var customConfigId = 'YOUR-CUSTOM-CONFIG-ID'; var searchTerm = 'microsoft';
傳送和接收搜尋要求
建立變數來儲存要求中傳送的資訊。 將搜尋字詞附加至
q=查詢參數,並將搜尋實例的自定義組態標識元附加至customconfig=參數,以建構要求 URL。 使用&符號分隔參數(&)。 您可以在下列程式代碼中使用全域端點,或使用 Azure 入口網站中針對您的資源顯示 自定義子域 端點。var info = { url: 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + "&" + 'customconfig=' + customConfigId, headers: { 'Ocp-Apim-Subscription-Key' : subscriptionKey } }使用 JavaScript 要求連結庫,將搜尋要求傳送至您的 Bing 自定義搜尋實例,並列印結果的相關信息,包括其名稱、URL,以及上次編目網頁的日期。
request(info, function(error, response, body){ var searchResponse = JSON.parse(body); for(var i = 0; i < searchResponse.webPages.value.length; ++i){ var webPage = searchResponse.webPages.value[i]; console.log('name: ' + webPage.name); console.log('url: ' + webPage.url); console.log('displayUrl: ' + webPage.displayUrl); console.log('snippet: ' + webPage.snippet); console.log('dateLastCrawled: ' + webPage.dateLastCrawled); console.log(); }