快速入門：使用 Node.js 和 Bing 新聞搜尋 REST API 來執行新聞搜尋

發行項
05/22/2020

警告

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

使用本快速入門，第一次呼叫 Bing 新聞搜尋 API。這個簡單的 JavaScript 應用程式會將搜尋查詢傳送給 API，然後顯示 JSON 回應。

雖然此應用程式是以 JavaScript 撰寫並以 Node.js 執行，但 API 是一種與大多數程式設計語言都相容的 RESTful Web 服務。

GitHub 上有此範例的原始程式碼。

必要條件

最新版的 Node.js。
JavaScript 要求程式庫。

建立 Azure 資源

藉由建立下列其中一項 Azure 資源，開始使用 Bing 新聞搜尋 API：

Bing 搜尋 v7 資源

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

多服務資源

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

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

在您最愛的 IDE 或編輯器中建立新的 JavaScript 檔案，並設定嚴謹度和 HTTPS 需求。
```
'use strict';
let https = require('https');
```
建立 API 端點、新聞 API 搜尋路徑、您的訂用帳戶金鑰和搜尋字詞的變數。您可以使用下列程式碼中的全域端點，或使用 Azure 入口網站中針對您的資源所顯示的自訂子網域端點。
```
let subscriptionKey = 'enter key here';
let host = 'api.cognitive.microsoft.com';
let path = '/bing/v7.0/news/search';
let term = 'Microsoft';
```

處理及剖析回應

定義一個名為 response_handler 的函式，此函式會接受 HTTP 呼叫 response 作為參數。

在接下來的步驟中，將程式碼新增至此函式。

定義一個變數來包含 JSON 回應本文。

let response_handler = function (response) {
    let body = '';
};

在呼叫 data 旗標時，儲存回應本文。

response.on('data', function (d) {
    body += d;
});

出現 end 旗標的訊號時，即可檢視 JSON 和標頭。

response.on('end', function () {
    console.log('\nRelevant Headers:\n');
    for (var header in response.headers)
        // header keys are lower-cased by Node.js
        if (header.startsWith("bingapis-") || header.startsWith("x-msedge-"))
             console.log(header + ": " + response.headers[header]);
    body = JSON.stringify(JSON.parse(body), null, '  ');
    console.log('\nJSON Response:\n');
    console.log(body);
 });

範例 JSON 回應

如以下範例所示，成功的回應會以 JSON 格式來傳回：

{
   "_type": "News",
   "readLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/news\/search?q=Microsoft",
   "totalEstimatedMatches": 36,
   "sort": [
      {
         "name": "Best match",
         "id": "relevance",
         "isSelected": true,
         "url": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/news\/search?q=Microsoft"
      },
      {
         "name": "Most recent",
         "id": "date",
         "isSelected": false,
         "url": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/news\/search?q=Microsoft&sortby=date"
      }
   ],
   "value": [
      {
         "name": "Microsoft to open flagship London brick-and-mortar retail store",
         "url": "http:\/\/www.contoso.com\/article\/microsoft-to-open-flagshi...",
         "image": {
            "thumbnail": {
               "contentUrl": "https:\/\/www.bing.com\/th?id=ON.F9E4A49EC010417...",
               "width": 220,
               "height": 146
            }
         },
         "description": "After years of rumors about Microsoft opening a brick-and-mortar...", 
         "about": [
           {
             "readLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/entiti...", 
             "name": "Microsoft"
           }, 
           {
             "readLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/entit...", 
             "name": "London"
           }
         ], 
         "provider": [
           {
             "_type": "Organization", 
             "name": "Contoso"
           }
         ], 
          "datePublished": "2017-09-21T21:16:00.0000000Z", 
          "category": "ScienceAndTechnology"
      }, 

      . . .
      
      {
         "name": "Microsoft adds Availability Zones to its Azure cloud platform",
         "url": "https:\/\/contoso.com\/2017\/09\/21\/microsoft-adds-availability...",
         "image": {
            "thumbnail": {
               "contentUrl": "https:\/\/www.bing.com\/th?id=ON.0AE7595B9720...",
               "width": 700,
               "height": 466
            }
         },
         "description": "Microsoft has begun adding Availability Zones to its...",
         "about": [
            {
               "readLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/entities\/a093e9b...",
               "name": "Microsoft"
            },
            {
               "readLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/entities\/cf3abf7d-e379-...",
               "name": "Windows Azure"
            },
            {
               "readLink": "https:\/\/api.cognitive.microsoft.com\/api\/v7\/entities\/9cdd061c-1fae-d0...",
               "name": "Cloud"
            }
         ],
         "provider": [
            {
               "_type": "Organization",
               "name": "Contoso"
            }
         ],
         "datePublished": "2017-09-21T09:01:00.0000000Z",
         "category": "ScienceAndTechnology"
      }
   ]
}

後續步驟

建立單頁 Web 應用程式