고객 지원 문의
시스템 상태
서문
비디오 라이브러리에서 비디오를 구성하는 데 사용되는 폴더를 만들 수 있습니다. 주제, 저자, 제품, 지역 등별로 동영상을 정리할 수 있습니다. 폴더에 동영상이 있으면 수백 또는 수천 개의 동영상이 있는 계정에서 쉽게 관리할 수 있습니다.
CMS API에 대한 자격 증명 가져오기
CMS API를 사용하려면 적절한 자격 증명이 필요합니다.
대부분의 경우 자격 증명을 얻는 가장 쉬운 방법은 Studio 관리 API 인증 섹션 (계정에 대한 관리자 권한 필요) 을 사용하는 것입니다. 자세한 내용은API 인증 자격 증명 관리를참조하십시오. 이 경우 필요한 권한은동영상 -읽기 및 쓰기 권한이 모두 필요합니다.
필요한 권한을 Studio에서 사용할 수 없거나 OAuth API에서 직접 가져오려는 경우 아래에 나열된클라이언트 자격 증명 가져오기문서를 선택합니다. 어떤 옵션을 선택하든 올바른 작업 권한을 요청해야합니다. 다음은 cURL 또는 우편 배달부와 함께 사용하여 적절한 권한을 얻을 수 있습니다.
"operations": [
"video-cloud/videos/read",
"video-cloud/videos/create",
"video-cloud/videos/update"]
폴더 만들기
다음은 새 폴더를 만드는 데 필요한 정보입니다.
요청 URL
을 만들다POST요청 :
https://cms.api.brightcove.com/v1/accounts/account_id/folders
요청 본문
{
"name": folder_name
}
대응
응답은 다음과 같습니다.
{
"id": "5a183efb10ab344b53775441",
"account_id": "57838016001",
"created_at": "2017-11-24T15:47:07.867Z",
"name": "places",
"updated_at": "2017-11-24T15:47:07.867Z",
"video_count": 0
}
폴더id과name (요청 본문에 설정 한 이름)은 중요합니다. 폴더에 비디오 추가 . 잊어 버려도 걱정하지 마세요id그러나 다음과 같이 언제든지이 정보를 다시 얻을 수 있기 때문입니다. 폴더 가져 오기계정.
폴더 가져 오기
계정에 대한 폴더 배열을 얻으려면GET요청 :
https://cms.api.brightcove.com/v1/accounts/account_id/folders
응답은 다음과 같습니다.
[
{
"id": "5a17275782aca45b631295f9",
"account_id": "57838016001",
"created_at": "2017-11-23T19:53:59.687Z",
"name": "birds",
"updated_at": "2017-11-23T20:06:24.537Z",
"video_count": 1
},
{
"id": "560039e5e4b0e69e4b01cacd",
"account_id": "57838016001",
"created_at": "2015-09-21T17:09:57.260Z",
"name": "fish",
"updated_at": "2017-11-02T19:03:40.751Z",
"video_count": 4
},
{
"id": "5a183efb10ab344b53775441",
"account_id": "57838016001",
"created_at": "2017-11-24T15:47:07.867Z",
"name": "places",
"updated_at": "2017-11-24T15:47:07.867Z",
"video_count": 0
},
{
"id": "560039f1e4b0e69e4b01cad3",
"account_id": "57838016001",
"created_at": "2015-09-21T17:10:09.422Z",
"name": "water",
"updated_at": "2015-09-21T17:22:52.935Z",
"video_count": 7
}
]
폴더에 비디오 추가
폴더에 비디오를 추가하려면PUT요청 :
https://cms.api.brightcove.com/v1/accounts/account_id/folders/folder_id/videos/video_id
요청 본문
이 작업에 대한 요청 본문이 없습니다.
대응
이 요청에 대한 응답은204 NO CONTENT .
폴더에서 비디오 제거
폴더에서 비디오를 제거하려면DELETE동영상을 추가하는 데 사용하는 것과 동일한 URL로 요청 :
https://cms.api.brightcove.com/v1/accounts/account_id/folders/folder_id/videos/video_id
요청 본문
이 요청의 경우 요청 본문에 폴더 이름도 포함해야합니다.
{
"name": folder_name
}
폴더에서 비디오 가져 오기
폴더에 비디오를 가져 오려면GET요청 :
https://cms.api.brightcove.com/v1/accounts/:account_id/folders/folder_id/videos
요청 매개 변수
기본적으로이 요청은 가장 최근에 폴더에 추가 된 20 개의 동영상을 반환합니다. 요청에 다음 매개 변수 중 하나 또는 둘 다를 추가하여이를 변경하고 많은 동영상이 포함 된 폴더에 대한 결과 페이지를 넘길 수 있습니다.
limit: 반환 할 동영상 수 (기본값 : 20, 최대 : 100)offset: 건너 뛸 동영상 수 (기본값 : 0)
예를 들어이 요청은 가능한 결과 중 21-30 개의 비디오를 반환합니다 (폴더에 많은 비디오가 포함되어 있다고 가정).
https://cms.api.brightcove.com/v1/accounts/:account_id/folders/folder_id/videos?limit=10&offset=20