入門
このトピックでは、を使用して、VideoCloudビデオに関するさまざまな種類の情報を取得する方法を学習します。 CMS APIリクエスト。これらのリクエストを作成するには、このドキュメントに記載されているエンドポイントをアカウント ID のベース URL に追加します。
https://cms.api.brightcove.com/v1/accounts/{account_id}/{endpoint}
へのリクエストCMS APIアクセストークンを含む認証ヘッダーが必要です。クライアントクレデンシャルを取得してアクセストークンを取得する方法の詳細については、「 Brightcove OAuth の概要」を参照してください。
動画を入手
Video Cloud アカウント内のすべての動画のデータを取得します。
エンドポイント: /videos
要求
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos
応答
[ {
"id" : "2114345471001",
"account_id" : "1507807800001",
"complete" : true,
"created_at" : "2013-01-23T19:06:16.328Z",
"cue_points" : [ {
"name" : "Flying Off",
"type" : "CODE",
"time" : 2.64,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Pre-roll",
"type" : "AD",
"time" : 0.0,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Bird Back",
"type" : "CODE",
"time" : 5.938,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Post-roll",
"type" : "AD",
"time" : 8.242,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
} ],
"custom_fields" : {
"customfield1" : "Approved",
"customfield2" : "Verified"
}, ...
]
ビデオをゲットする
特定の動画または複数の動画のデータを ID で取得する
エンドポイント: /videos/{video_id}[,{video2_id},{video3_id}]
要求
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/2114345471001
応答
{
"id" : "2114345471001",
"account_id" : "1507807800001",
"complete" : true,
"created_at" : "2013-01-23T19:06:16.328Z",
"cue_points" : [ {
"name" : "Flying Off",
"type" : "CODE",
"time" : 2.64,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Pre-roll",
"type" : "AD",
"time" : 0.0,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, {
"name" : "Bird Back",
"type" : "CODE",
"time" : 5.938,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, ...
ソースを取得
特定のビデオのソースを取得します。
エンドポイント: /videos/{video_id}/sources
要求
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/2114345471001/sources
応答
[
{
"asset_id": "5164827527001",
"remote": false,
"src": "http://brightcove.vo.llnwd.net/e2/hls/57838016001/57838016001_5164827527001_5164799982001.m3u8?pubId=57838016001&videoId=5164799982001",
"type": "application/vnd.apple.mpegurl"
},
{
"asset_id": "5164827527001",
"remote": false,
"src": "https://brightcove.hs.llnwd.net/e2/hls/57838016001/57838016001_5164827527001_5164799982001.m3u8?pubId=57838016001&videoId=5164799982001",
"type": "application/vnd.apple.mpegurl"
}, ...
]
画像を取得
特定のビデオの画像を取得します。
エンドポイント: /videos/{video_id}/images
要求
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/2114345471001/images
応答
{
"thumbnail" : {
"id" : "3815806023001",
"src" : "http://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/2431/1507807800001_3815806023001_thumb.jpg?pubId=1507807800001"
},
"poster" : {
"id" : "3815782921001",
"src" : "http://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/273/1507807800001_3815782921001_still.jpg?pubId=1507807800001"
}
}
refidでビデオを取得する
参照 ID を使用して、特定のビデオのデータを取得します。
エンドポイント: /videos/ref:{video_reference_id}
要求
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/ref:titmouse_title_refid7
応答
{
"id" : "2114345471001",
"account_id" : "1507807800001",
"complete" : true,
"created_at" : "2013-01-23T19:06:16.328Z",
"cue_points" : [ {
"name" : "Flying Off",
"type" : "CODE",
"time" : 2.64,
"metadata" : null,
"force_stop" : false,
"asset_id" : null
}, ...
refidでソースを取得
参照 ID を使用して、特定のビデオのソースを取得します。
エンドポイント: /videos/ref:{video_reference_id}/sources
要求
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/ref:titmouse_title_refid7/sources
応答
[
{
"asset_id": "5192219618001",
"remote": false,
"src": "http://brightcove.vo.llnwd.net/v1/uds/pd/57838016001/201611/3753/57838016001_5192219618001_5192207668001.mp4?pubId=57838016001&videoId=5192207668001",
"codec": "H264",
"container": "MP4",
"encoding_rate": 1823000,
"duration": 41237,
"height": 540,
"width": 960,
"size": 9417086,
"uploaded_at": "2016-11-01T09:37:37.336Z"
},
{
"asset_id": "5192219618001",
"remote": false,
"src": "https://brightcove.hs.llnwd.net/v1/uds/pd/57838016001/201611/3753/57838016001_5192219618001_5192207668001.mp4?pubId=57838016001&videoId=5192207668001",
"codec": "H264",
"container": "MP4",
"encoding_rate": 1823000,
"duration": 41237,
"height": 540,
"width": 960,
"size": 9417086,
"uploaded_at": "2016-11-01T09:37:37.336Z"
}, ...
]
refidで画像を取得
参照 ID を使用して、特定のビデオの画像を取得します。
エンドポイント: /videos/ref:{video_reference_id}/images
要求
https://cms.api.brightcove.com/v1/accounts/1507807800001/videos/ref:titmouse_title_refid7/images
応答
{
"thumbnail" : {
"id" : "3815806023001",
"src" : "http://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/2431/1507807800001_3815806023001_thumb.jpg?pubId=1507807800001"
},
"poster" : {
"id" : "3815782921001",
"src" : "http://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/273/1507807800001_3815782921001_still.jpg?pubId=1507807800001"
}
}