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

    해당 항목을 사용하여 재생 목록 관리 CMS API

    이 항목에서는 다음을 사용하여 재생 목록을 생성, 업데이트 또는 삭제하는 방법에 대해 설명합니다. CMS API.

    소개

    샘플 재생 목록

    재생 목록을 사용하면 관련 동영상 세트를 함께 그룹화하여 player 그리고 그룹으로 보았다. 그만큼 CMS API 재생 목록을 생성, 업데이트 또는 삭제하는 데 사용할 수있는 일련의 쓰기 메소드가 있습니다.

    인증

    에 대한 요청 CMS API 액세스 토큰을 포함하는 인증 헤더가 필요합니다. 클라이언트 자격 증명을 얻고 액세스 토큰을 검색하는 데 사용하는 방법에 대한 자세한 내용은 Brightcove OAuth 개요.

    재생 목록 가져 오기

    재생 목록을 작성하기 전에 기존의 재생 목록에 대한 데이터를 검색하는 방법을 알아 보겠습니다. Video Cloud 계정입니다.

    의뢰

        https://cms.api.brightcove.com/v1/accounts/{account_id}/playlists

    응답

    (우리는 limit 이 요청에 1 응답을 작게 유지하십시오.)

        [
          {
            "id": "5282200243001",
            "account_id": "1752604059001",
            "created_at": "2017-01-15T15:30:09.847Z",
            "description": "Do not delete",
            "favorite": true,
            "name": "Playlist for Alltime Views Sample",
            "reference_id": null,
            "type": "EXPLICIT",
            "updated_at": "2017-01-15T17:49:07.633Z",
            "video_ids": [
              "4825279519001",
              "4845831078001",
              "4825296720001",
              "4454620115001",
              "5141730843001",
              "4793962133001",
              "4454620113001",
              "4511340777001",
              "5045678909001"
            ]
          }
        ]

    재생 목록 유형

    하나있다. EXPLICIT 비디오 ID의 배열로 포함될 비디오를 지정하는 (수동) 재생 목록 유형입니다. 또한 7 개의 스마트 재생 목록 유형이 있습니다. 스마트 재생 목록 유형은 검색 문자열을 사용하여 동적으로 선택되는 비디오 세트를 정렬하는 방법이 다릅니다. 아래 표는 모든 재생 목록 유형을 보여줍니다.

    재생 목록 유형
    거래증명방식 상품 상세정보
    EXPLICIT 수동 재생 목록. 포함 된 동영상과 그 모양의 순서는 일련의 동영상 ID로 정의됩니다.
    ACTIVATED_OLDEST_TO_NEWEST 선택한 동영상이 활성화 날짜별로 정렬 된 스마트 재생 목록입니다 (오름차순).
    ACTIVATED_NEWEST_TO_OLDEST 선택한 동영상이 활성화 날짜별로 정렬 된 스마트 재생 목록입니다 (내림차순).
    ALPHABETICAL 선택한 비디오가 알파벳순으로 이름순으로 표시되는 스마트 재생 목록입니다.
    PLAYS_TOTAL 선택한 비디오가 상영 횟수 (내림차순)로 정렬 된 스마트 재생 목록입니다.
    PLAYS_TRAILING_WEEK 선택한 동영상이 지난 주에 재생 횟수 (내림차순)로 정렬되는 스마트 재생 목록입니다.
    START_DATE_OLDEST_TO_NEWEST 선택한 동영상이 예약 된 시작 날짜 (오름차순)로 정렬되는 스마트 재생 목록입니다.
    START_DATE_NEWEST_TO_OLDEST 선택한 동영상이 예약 된 시작 날짜 (내림차순)로 정렬되는 스마트 재생 목록입니다.

    검색 필드

    모든 스마트 재생 목록 유형에 대해 동영상 컬렉션은 search 재생 목록의 필드 값입니다. 검색 필드 값은 태그에 대한 유효한 검색 문자열이어야합니다. 검색 문자열 위한 CMS API. 다음은 그들이 반환 할 동영상에 대한 설명과 함께 몇 가지 예입니다.

    샘플 검색 문자열
    검색 문자열 상품 상세정보
    +tags:bird 태그 "bird"가있는 동영상을 반환합니다.
    +tags:bird,woodland 태그 "bird"와 "woodland"가 모두있는 동영상을 반환합니다.
    tags:bird,woodland 가지고있는 동영상을 반환합니다. 태그 "bird"또는 "woodland"(주의 : + 검색 문자열에서 로그 아웃하면 차이가 발생합니다.)

    동영상 개수 가져 오기

    다음을 사용하여 재생 목록 (스마트 또는 수동)에서 동영상 수를 얻을 수 있습니다. counts 종점 :

        https://cms.api.brightcove.com/v1/accounts/account_id/playlists/playlist_id/videos

    플레이 리스트 만들기

    새로운 재생 목록을 만들려면 POST 요청 :

        https://cms.api.brightcove.com/v1/accounts/{account_id}/playlists

    본문 요청

    요청에 비디오 메타 데이터 필드 중 많은 수 (전부는 아님!)를 포함 할 수 있습니다. 당신 절대로 필요한 것 적어도 nametype 재생 목록 아래는 EXPLICIT 재생 목록을 만드는 두 가지 예이고, 두 번째는 태그가 두 개인 동영상을 포함하여 ACTIVATED_NEWEST_TO_OLDEST 유형의 스마트 재생 목록을 만드는 예입니다.

    EXPLICIT 재생 목록

        {
          "type": "EXPLICIT",
          "name": "My manual playlist",
          "video_ids": [
            "5289680419001",
            "5289693763001",
            "5289680417001",
            "5288472314001"
          ]
        }

    스마트 재생 목록 용

        {
          "type": "ACTIVATED_NEWEST_TO_OLDEST",
          "name": "My smart playlist",
          "search": "+tags:bird-tags:sea"
        }

    을 참조 API 참조 재생 목록 생성에 사용할 수있는 모든 필드에 대해

    재생 목록 업데이트

    재생 목록을 업데이트하는 것은 재생 목록을 만드는 것과 매우 유사합니다. 유일한 차이점은 요청 방법입니다 ( PATCH POST 대신) 및 재생 목록 ID가 URL에 추가됩니다. 요청 본문의 필드는 완전히 동일합니다.

    요청 URL

        https://cms.api.brightcove.com/v1/accounts/account_id/playlists/playlist_id

    에서 세부 정보 찾기 API 참조.

    재생 목록 삭제

    재생 목록을 삭제하려면 DELETE 방법 :

        https://cms.api.brightcove.com/v1/accounts/account_id/playlists/playlist_id

    재생 목록을 업데이트하는 데 사용 된 것과 동일한 URL입니다.

    에서 세부 정보 찾기 API 참조.


    페이지 최종 업데이트 28 Sep 2020