폴더 작업

소개

비디오 라이브러리에서 비디오를 구성하는 데 사용되는 폴더를 만들 수 있습니다. 주제, 저자, 제품, 지역별로 비디오를 구성 할 수 있습니다. 폴더에 비디오를 저장하면 수백 또는 수천 개의 비디오가있는 계정에서 쉽게 관리 할 수 있습니다.

해당 사용자의 자격 증명 얻기 CMS API

을 사용하려면 CMS API 적절한 자격 증명이 필요합니다.

대부분의 경우 자격증 명을 얻는 가장 쉬운 방법은 Studio Admin API 인증 섹션을 이용하는 것입니다 (계정에 대한 관리자 권한이 필요함). 만나다 API 인증 자격 증명 관리 자세한 내용은 이 경우 필요한 권한은 다음과 같습니다. 동영상 - 읽기 및 쓰기 권한이 필요합니다.

필요한 사용 권한을 Studio에서 사용할 수 없거나 사용자가 직접 사용하도록 설정하려는 경우 OAuth API, 당신이 선택한 것을 사용하십시오. 클라이언트 자격증 명 얻기 아래에 나열된 문서. 어느 옵션을 선택하든 올바른 작업 권한을 요청해야합니다. cURL 또는 Postman과 함께 다음을 사용하여 적절한 권한을 얻을 수 있습니다.

           "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