서문
이 항목에서는CMS API요청을 사용하여 Video Cloud 비디오에 대한 다양한 종류의 정보를 검색하는 방법을 알아봅니다. 이러한 요청을 생성하려면이 문서에 나열된 엔드 포인트를 계정 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": "https://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" : "https://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/2431/1507807800001_3815806023001_thumb.jpg?pubId=1507807800001"
},
"poster" : {
"id" : "3815782921001",
"src" : "https://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": "https://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" : "https://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/2431/1507807800001_3815806023001_thumb.jpg?pubId=1507807800001"
},
"poster" : {
"id" : "3815782921001",
"src" : "https://brightcove.vo.llnwd.net/v1/unsecured/media/1507807800001/201410/273/1507807800001_3815782921001_still.jpg?pubId=1507807800001"
}
}