快速入門：使用 Bing 影片搜尋 REST API 和 Node.js 來搜尋影片
警告
在 2020 年 10 月 30 日，Bing 搜尋 API 已從 Azure AI 服務移至 Bing 搜尋 服務。 本文件僅供參考之用。 如需更新的文件，請參閱 Bing 搜尋 API 文件。 如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。
使用本快速入門，第一次呼叫 Bing 影片搜尋 API。 這個簡單的 JavaScript 應用程式會將 HTTP 影片搜尋查詢傳送給 API，並顯示 JSON回應。 雖然此應用程式是以 JavaScript 撰寫，並且使用 Node.js，但 API 是一種與大多數程式設計語言都相容的 RESTful Web 服務。
GitHub 上有此範例的原始程式碼，其中還有其他錯誤處理和註釋。
Prerequisites
適用於 JavaScript 的要求模組。 使用
npm install request來安裝此模組。
建立 Azure 資源
藉由建立下列其中一項 Azure 資源，開始使用 Bing 影片搜尋 API：
- 您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
- 使用免費定價層來試用服務，之後可升級至付費層以用於實際執行環境。
- 您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
- 針對您的應用程式，跨多個 Azure AI 服務使用相同的金鑰和端點。
初始化應用程式
在您最愛的 IDE 或編輯器中建立新的 JavaScript 檔案。 設定嚴謹度，並新增下列需求：
'use strict'; let https = require('https');為您的 API 端點、訂用帳戶金鑰及搜尋字詞建立變數。 對於
host值，您可以使用下列程式碼中的全域端點，或使用 Azure 入口網站中針對您的資源所顯示的自訂子網域端點。let subscriptionKey = 'enter key here'; let host = 'api.cognitive.microsoft.com'; let path = '/bing/v7.0/videos/search'; let term = 'kittens';
建立回應處理常式
建立名為
response_handler的函式，以取得來自 API 的 JSON 回應。 建立回應本文的變數。 收到data旗標時，使用response.on()附加回應。let response_handler = function (response) { let body = ''; response.on('data', function (d) { body += d; }); };在此函式中，當系統通知
end儲存 Bing 相關標題 (以bingapis或x-msedge-開始) 時，請使用response.on()。 然後使用JSON.parse()剖析 JSON，並使用JSON.stringify()將其轉換成字串並列印。response.on('end', function () { 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, ' '); //JSON Response body console.log(body); });
建立及傳送搜尋要求
建立稱為 bing_video_search() 的函式。 新增要求的參數，包括您的主機名稱和標頭。 編碼搜尋字詞，並以 ?q= 參數將其附加到 path 參數。 然後以 req.end() 傳送要求。
let bing_video_search = function (search_term) {
console.log('Searching videos for: ' + term);
let request_params = {
method : 'GET',
hostname : host,
path : path + '?q=' + encodeURIComponent(search_term),
headers : {
'Ocp-Apim-Subscription-Key' : subscriptionKey,
}
};
let req = https.request(request_params,
response_handler);
req.end();
}
JSON 回應
如以下範例所示，成功的回應會以 JSON 格式來傳回：
{
"_type": "Videos",
"instrumentation": {},
"readLink": "https://api.cognitive.microsoft.com/api/v7/videos/search?q=kittens",
"webSearchUrl": "https://www.bing.com/videos/search?q=kittens",
"totalEstimatedMatches": 1000,
"value": [
{
"webSearchUrl": "https://www.bing.com/videos/search?q=kittens&view=...",
"name": "Top 10 cute kitten videos compilation",
"description": "HELP HOMELESS ANIMALS AND WIN A PRIZE BY CHOOSING...",
"thumbnailUrl": "https://tse4.mm.bing.net/th?id=OVP.n1aE_Oikl4MtzBb...",
"datePublished": "2014-11-12T22:47:36.0000000",
"publisher": [
{
"name": "Fabrikam"
}
],
"creator": {
"name": "Marcus Appel"
},
"isAccessibleForFree": true,
"contentUrl": "https://www.fabrikam.com/watch?v=8HVWitAW-Qg",
"hostPageUrl": "https://www.fabrikam.com/watch?v=8HVWitAW-Qg",
"encodingFormat": "h264",
"hostPageDisplayUrl": "https://www.fabrikam.com/watch?v=8HVWitAW-Qg",
"width": 480,
"height": 360,
"duration": "PT3M52S",
"motionThumbnailUrl": "https://tse4.mm.bing.net/th?id=OM.j4QyJAENJphdZQ_1501386166&pid=Api",
"embedHtml": "<iframe width=\"1280\" height=\"720\" src=\"https://www.fabrikam.com/embed/8HVWitAW-Qg?autoplay=1\" frameborder=\"0\" allowfullscreen></iframe>",
"allowHttpsEmbed": true,
"viewCount": 7513633,
"thumbnail": {
"width": 300,
"height": 168
},
"videoId": "655D98260D012432848F6558260D012432848F",
"allowMobileEmbed": true,
"isSuperfresh": false
},
. . .
],
"nextOffset": 36,
"queryExpansions": [
{
"text": "Kittens Meowing",
"displayText": "Meowing",
"webSearchUrl": "https://www.bing.com/videos/search?q=Kittens+Meowing...",
"searchLink": "https://api.cognitive.microsoft.com/api/v7/videos/search...",
"thumbnail": {
"thumbnailUrl": "https://tse3.mm.bing.net/th?q=Kittens+Meowing&pid..."
}
},
{
"text": "Funny Kittens",
"displayText": "Funny",
"webSearchUrl": "https://www.bing.com/videos/search?q=Funny+Kittens...",
"searchLink": "https://api.cognitive.microsoft.com/api/v7/videos/search...",
"thumbnail": {
"thumbnailUrl": "https://tse3.mm.bing.net/th?q=Funny+Kittens&..."
}
},
. . .
],
"pivotSuggestions": [
{
"pivot": "kittens",
"suggestions": [
{
"text": "Cat",
"displayText": "Cat",
"webSearchUrl": "https://www.bing.com/videos/search?q=Cat...",
"searchLink": "https://api.cognitive.microsoft.com/api/v7/videos/search?...",
"thumbnail": {
"thumbnailUrl": "https://tse3.mm.bing.net/th?q=Cat&pid=Api..."
}
},
{
"text": "Feral Cat",
"displayText": "Feral Cat",
"webSearchUrl": "https://www.bing.com/videos/search?q=Feral+Cat...",
"searchLink": "https://api.cognitive.microsoft.com/api/v7/videos/search...",
"thumbnail": {
"thumbnailUrl": "https://tse3.mm.bing.net/th?q=Feral+Cat&pid=Api&..."
}
}
]
}
],
"relatedSearches": [
{
"text": "Kittens Being Born",
"displayText": "Kittens Being Born",
"webSearchUrl": "https://www.bing.com/videos/search?q=Kittens+Being+Born...",
"searchLink": "https://api.cognitive.microsoft.com/api/v7/videos/search?...",
"thumbnail": {
"thumbnailUrl": "https://tse1.mm.bing.net/th?q=Kittens+Being+Born&pid=..."
}
},
. . .
]
}