快速入門：使用 Bing 影片搜尋 REST API 和 C# 來搜尋影片
警告
2020 年 10 月 30 日，Bing 搜尋 API 已從 Azure AI 服務移至Bing 搜尋服務。 本文件僅供參考之用。 如需更新的文件，請參閱 Bing 搜尋 API 文件。 如需針對 Bing 搜尋建立新 Azure 資源的指示，請參閱透過 Azure Marketplace 建立 Bing 搜尋資源。
使用本快速入門，第一次呼叫 Bing 影片搜尋 API。 這個簡單的 C# 應用程式會將 HTTP 影片搜尋查詢傳送至 API，並顯示 JSON 回應。 雖然此應用程式是以 C# 撰寫的，但 API 是一種與大多數程式設計語言都相容的 RESTful Web 服務。
GitHub 上有此範例的原始程式碼，其中還有其他錯誤處理、功能和程式碼註釋。
Prerequisites
您將必須設定電腦以執行 .NET Core。 您可以在 .NET Core 下載 頁面上找到安裝指示。 您可以在 Windows、Linux、macOS 或 Docker 容器中執行此應用程式。 您將必須安裝慣用的程式碼編輯器。 以下說明使用 Visual Studio Code，這是一個開放原始碼的跨平台編輯器。 不過，您可以使用您熟悉的任何工具。
建立 Azure 資源
藉由建立下列其中一項 Azure 資源，開始使用 Bing 影片搜尋 API：
- 您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
- 使用免費定價層來試用服務，之後可升級至付費層以用於實際執行環境。
- 您可以透過 Azure 入口網站取得該資源，直到將其刪除為止。
- 針對您的應用程式，跨多個 Azure AI 服務使用相同的金鑰和端點。
建立專案並將其初始化
第一個步驟是建立新的應用程式。 請開啟命令提示字元，然後為您的應用程式建立新目錄。 使該目錄成為目前的目錄。 在主控台視窗中輸入下列命令：
dotnet new console --name VideoSearchClient
您必須在 Main 方法的頂端新增下列 using 指示詞，讓 C# 編譯器能夠辨識工作和 JSON 類型：
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Collections.Generic;
using System.Text.Json;
using System.Text.Json.Serialization;
針對您的訂用帳戶金鑰、端點和搜尋字詞新增變數。 對於 uriBase 值，您可以使用下列程式碼中的全域端點，或使用在 Azure 入口網站中針對您的資源顯示的自訂子網域端點。
// Replace the accessKey string value with your valid access key.
const string _accessKey = "enter your key here";
// Or use the custom subdomain endpoint displayed in the Azure portal for your resource.
const string _uriBase = "https://api.cognitive.microsoft.com/bing/v7.0/videos/search";
const string _searchTerm = "kittens";
接著，更新 Main 方法，以便使用非同步方法。 新增 async 修飾詞，並將傳回類型變更為「工作」。
static async Task Main(string[] args)
{
}
現在，您會有一個僅以非同步方式執行工作的程式。 來加以改善吧。
建立資料結構以保存 Bing 影片搜尋 API 回應
定義 SearchResult 和 Video 類別，以包含影片搜尋結果。 後續當您需要 JSON 結果中的其他欄位時，可以新增更多屬性。
class SearchResult
{
[JsonPropertyName("totalEstimatedMatches")]
public int TotalEstimatedMatches { get; set; }
[JsonPropertyName("value")]
public List<Video> Videos { get; set; }
}
class Video
{
[JsonPropertyName("name")]
public string Name { get; set; }
[JsonPropertyName("description")]
public string Description { get; set; }
[JsonPropertyName("thumbnailUrl")]
public string ThumbnailUrl { get; set; }
[JsonPropertyName("contentUrl")]
public string ContentUrl { get; set; }
}
建立及處理影片搜尋要求
我們使用 HttpClient 來執行對 API 的呼叫。 首先，我們需要新增標頭 Ocp-Apim-Subscription-Key 和您的存取金鑰。
using var client = new HttpClient();
client.BaseAddress = new Uri(_uriBase);
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", _accessKey);
建構搜尋要求的 URI。 將搜尋詞彙 _searchTerm 格式化，然後再附加至字串。
var response = await client.GetAsync($"?q={Uri.EscapeDataString(_searchTerm)}");
處理結果
當回應成功時，我們可以處理 JSON 資料。 我們已將 JSON 字串還原序列化為先前建立的 SearchResult。 將迴圈新增至結果 (如果有的話)，並將結果列印至主控台。
if (response.IsSuccessStatusCode)
{
var json = await response.Content.ReadAsStringAsync();
var result = JsonSerializer.Deserialize<SearchResult>(json);
foreach (var video in result.Videos)
{
Console.WriteLine($"Name: {video.Name}");
Console.WriteLine($"ContentUrl: {video.ContentUrl}");
Console.WriteLine();
}
}
範例 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=..."
}
},
. . .
]
}