지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    폴더 작업

    이 항목에서는 Video Cloud 미디어 라이브러리에 폴더를 추가하고 CMS API를 사용하여 폴더에 비디오를 추가하는 방법에 대해 알아봅니다.

    서문

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

    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
          }

    폴더idname (요청 본문에 설정 한 이름)은 중요합니다. 폴더에 비디오 추가 . 잊어 버려도 걱정하지 마세요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