將搜尋要求傳送至 Bing 影片搜尋 API

發行項
12/03/2019

警告

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

本文說明傳送給 Bing 影片搜尋 API 的要求參數和屬性，以及其傳回的 JSON 回應物件。

建立 Azure 資源

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

Bing 搜尋 v7 資源

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

多服務資源

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

使用 Bing 自動建議 API 建議搜尋字詞

若您提供使用者可在其中輸入其搜尋字詞的搜尋方塊，請使用 Bing 自動建議 API 來改善使用經驗。 API 會根據部分搜尋字詞傳回建議的查詢字串，作為使用者類型。

在使用者輸入其搜尋字詞之後，會先對此字詞進行 URL 編碼，再設定 q 查詢參數。例如，如果使用者輸入 sailing dinghies，請將 q 設定為 sailing+dinghies 或 sailing%20dinghies。

傳送要求

若要取得影片搜尋結果，您要將 GET 要求傳送至下列端點：

https://api.cognitive.microsoft.com/bing/v7.0/videos/search

要求必須使用 HTTPS 通訊協定。

建議讓所有要求來自伺服器。隨著用戶端應用程式散佈金鑰，會讓惡意的第三方有更多機會存取該應用程式。從伺服器進行呼叫，API 未來也就能以同個升級點更新版本。

要求必須指定 q 查詢參數，其中含有使用者的搜尋字詞。雖是選擇性，但請在要求中指定 mkt 查詢參數，其可識別您希望從哪個市場取得結果。如需選用查詢參數 (例如 pricing) 的清單，請參閱查詢參數。所有查詢參數值均須為 URL 編碼。

要求必須指定 Ocp-Apim-Subscription-Key 標頭。雖然是選擇性的，但我們仍建議使用以下標頭：

用戶端 IP 和位置標頭對於傳回位置感知內容很重要。

如需所有要求和回應標頭的清單，請參閱標頭。

範例搜尋要求

以下顯示搜尋要求，其包含所有建議的查詢參數和標頭。如果這是您第一次呼叫任何的 Bing API，請勿包含用戶端識別碼標頭。如果您先前已呼叫 Bing API 且 Bing 傳回了使用者和裝置組合的用戶端識別碼，則只要包含用戶端識別碼。

GET https://api.cognitive.microsoft.com/bing/v7.0/videos/search?q=sailing+dinghies&mkt=en-us HTTP/1.1  
Ocp-Apim-Subscription-Key: 123456789ABCDE  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)  
X-Search-ClientIP: 999.999.999.999  
X-Search-Location: lat:47.60357;long:-122.3295;re:100  
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>  
Host: api.cognitive.microsoft.com

範例 JSON 回應

以下顯示前一個要求的回應。此範例也示範 Bing 特定回應標頭。

注意

因為 URL 格式和參數可隨時變更而不會另行通知，因此請依原狀使用所有 URL。除非有註明，否則請勿相依於 URL 格式或參數。

BingAPIs-TraceId: 76DD2C2549B94F9FB55B4BD6FEB6AC
X-MSEdge-ClientID: 1C3352B306E669780D58D607B96869
BingAPIs-Market: en-US

{
    "_type" : "Videos",
    "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=81EF7545D5694...",
    "totalEstimatedMatches" : 1000,
    "value" : [
        {
            "name" : "How to sail - What to Wear for Dinghy Sailing",
            "description" : "An informative video on what to wear when...",
            "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=81EF7545D56...",
            "thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?id=OVP.DYWCvh...",
            "datePublished" : "2014-03-04T11:51:53",
            "publisher" : [
                {
                    "name" : "Fabrikam"
                }
            ],
            "creator" : {
                "name" : "Marcus Appel"
            },
            "contentUrl" : "https:\/\/www.fabrikam.com\/watch?v=vzmPjHZ--g",
            "hostPageUrl" : "https:\/\/www.bing.com\/cr?IG=81EF7545D56944...",
            "encodingFormat" : "h264",
            "hostPageDisplayUrl" : "https:\/\/www.fabrikam.com\/watch?v=vzmPjBZ--g",
            "width" : 1280,
            "height" : 720,
            "duration" : "PT2M47S",
            "motionThumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?id=OM.Y6...",
            "embedHtml" : "<iframe width=\"1280\" height=\"720\" src=\"https:...><\/iframe>",
            "allowHttpsEmbed" : true,
            "viewCount" : 8743,
            "thumbnail" : {
                "width" : 300,
                "height" : 168
            },
            "videoId" : "6DB795E11A6E3CBAAD636DB795E11E3CBAAD63",
            "allowMobileEmbed" : true,
            "isSuperfresh" : false
        },
        . . .
    ],
    "nextOffset" : 0,
    "pivotSuggestions" : [
        {
            "pivot" : "sailing",
            "suggestions" : []
        },
        {
            "pivot" : "dinghies",
            "suggestions" : [
                {
                    "text" : "Sailing Cruising",
                    "displayText" : "Cruising",
                    "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=81EF754...",
                    "searchLink" : "https:\/\/api.cognitive.microsoft.com...",
                    "thumbnail" : {
                        "thumbnailUrl" : "https:\/\/tse4.mm.bing.net\/th?q=Sailing..."
                    }
                },
                . . .
            ]
        }
    ]
}

下一步

試用 API。移至影片搜尋 API 測試主控台。

如需關於取用回應物件的詳細資料，請參閱搜尋網路上的影片 (英文)。

如需取得影片的深入解析 (例如相關搜尋) 的詳細資料，請參閱影片深入解析 (英文)。

如需社交媒體上發燒影片的詳細資料，請參閱發燒影片 (英文)。

共用方式為