ビデオに関する分析情報を取得する
警告
2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。 このドキュメントは、参考用としてのみ提供されています。 更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、「Azure Marketplace から Bing Search リソースを作成する」を参照してください。
Bing Video Search API によって返される各ビデオには、関連するビデオなど、ビデオに関する詳細情報を取得するために使用できるビデオ ID が含まれています。 ビデオに関する分析情報を取得するには、API 応答内の videoId トークンを取得します。
"value" : [
{
. . .
"name" : "How to sail - What to Wear for Dinghy Sailing",
"description" : "An informative video on what to wear...",
"contentUrl" : "https:\/\/www.fabrikam.com\/watch?v=vzmPjHBZ--g",
"videoId" : "6DB795E11A6E3CBAAD636DB795E11A6E3CBAAD63",
. . .
}
],
その後、ID を使用して Video Details エンドポイントに GET 要求を送信します。 このとき、id クエリ パラメーターを videoId トークンに設定します。 取得する分析情報を指定するには、modules クエリ パラメーターを設定します。 すべての分析情報を取得するには、modules を All に設定します。 応答には、要求したすべての分析情報 (使用可能な場合) が含まれます。
GET https://api.cognitive.microsoft.com/bing/v7.0/videos/details?q=sailiing+dinghies&id=6DB795E11A6E3CBAAD636DB795E11A6E3CBAAD63&modules=All&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-MSEdge-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
関連ビデオの分析情報の取得
指定したビデオに関連するビデオを取得するには、modules クエリ パラメーターを RelatedVideos に設定します。
GET https://api.cognitive.microsoft.com/bing/v7.0/videos/details?q=sailiing+dinghies&id=6DB795E11A6E3CBAAD636DB795E11A6E3CBAAD63&modules=RelatedVideos&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
この要求への応答は、Videos オブジェクトではなく、最上位の VideoDetails オブジェクトを持ちます。
{
"_type" : "Api.VideoDetails.VideoDetails",
"relatedVideos" : {
"value" : [
{
"name" : "How to sail - Reefing a Sail",
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=7284B07...",
"thumbnailUrl" : "https:\/\/tse3.mm.bing.net\/th?id=OVP.zt...",
"datePublished" : "2014-03-04T16:11:09",
"publisher" : [
{
"name" : "Fabrikam"
}
],
"contentUrl" : "https:\/\/www.fabrikam.com\/watch?v=...",
"hostPageUrl" : "https:\/\/www.bing.com\/cr?IG=7284B07...",
"hostPageDisplayUrl" : "https:\/\/www.fabrikam.com\/watch?...",
"duration" : "PT4M56S",
"motionThumbnailUrl" : "https:\/\/tse1.mm.bing.net\/th?id=OM...",
"allowHttpsEmbed" : true,
"viewCount" : 21756,
"videoId" : "AC1A157A4DDB571D03D6AC157A4DDB571D03D6",
"allowMobileEmbed" : false,
"isSuperfresh" : false
},
. . .
]
}
}