폴더 작업

서문

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

폴더 만들기

다음은 새 폴더를 만드는 데 필요한 정보입니다.

요청 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 .

폴더에서 비디오 제거

폴더에서 동영상을 삭제하려면 동영상을 추가할 때 사용한 것과 동일한 URL로DELETE요청하세요.

      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

요청 매개 변수

limit및offset

기본적으로이 요청은 가장 최근에 폴더에 추가 된 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

sort

sort매개 변수를 사용하여 반환되는 비디오를 다음 필드 중 하나와 동일하게 설정하여 반환되는 비디오를 정렬할 수도 있습니다.

• 이름
• 참조 ID
• 업데이트됨
• 생성한_AT
• 게시됨_at
• schedule_starts_at
• schedule_ends_at
• 국가
• play_total
• 재생_후행_주

내림차순으로 정렬하려면 필드 값 앞에 마이너스 sige ( -created_at ) 를 붙입니다.

의 기본값은sort입니다-updated_at .