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

    백롯/비디오 클라우드 CMS 커넥터

    백로트CMS API어댑터는 Video Cloud API로 전환하는 동안 통합 및 앱의 작동을 유지할 수 있도록 선택한 작업 세트를 지원합니다. Backlot API 비디오 클라우드 플랫폼 API에 대한 자세한 내용은브라이트코브 API 시작하기를참조하십시오.

    요구 사항

    광고 세트 엔드포인트

    Video Cloud에는ad_set이지만 동영상과 관련된 광고 세트 데이터는cue_points , 그리고ad_set_id광고 세트와 연결된 동영상을 식별 할 수 있도록 해당 이름의 맞춤 입력란에 저장됩니다.

    비디오 클라우드로 마이그레이션 참조: 광고 세트 - 광고 세트 데이터가 서로 다른 광고 소스의 큐포인트에 매핑되는 방법에 대한 자세한 내용은

    아래 표에는 지원되는Backlot APIad_sets작업이 나와 있습니다.

    ad_sets 엔드포인트
    백로트 API 엔드포인트 방법 지원 참고
    v2/ad_sets GET 예
    • Video Cloud에는 광고 세트 개념이 없습니다. 각 광고 세트와 관련된 일부 정보는 광고 세트가 연결된 동영상의 cuepoint 데이터로 마이그레이션됩니다. 자세한 내용은광고 세트를참조하십시오.
    POST 아니요
    • Video Cloud에는 광고 세트 개념이 없으므로 광고 세트 생성을 시도하면 실패합니다.
    v2/ad_sets/{set_id} GET 예
    • Video Cloud에는 광고 세트 개념이 없습니다. 각 광고 세트와 관련된 일부 정보는 광고 세트가 연결된 동영상의 cuepoint 데이터로 마이그레이션됩니다. 자세한 내용은광고 세트를참조하십시오.
    PATCH 예
    • 이 요청은 관련 동영상에 대한 큐 포인트 데이터를 업데이트합니다
    DELETE 예
    • 이 요청은 관련 동영상에 대한 큐 포인트 데이터를 삭제합니다
    v2/ad_sets/{set_id}ads POST 예
    • 관련 동영상에 큐 포인트 추가
    DELETE 예
    • 관련 비디오에서 큐포인트 제거

    자산 엔드포인트

    아래 표에는 지원되는Backlot APIasset작업이 나와 있습니다.

    SQL 문을 사용하여 자산 작업의 필터링을 제공하는Query API는부분적으로만 지원됩니다. whereorderby쿼리는 지원되지않습니다 . limit쿼리가 작동해야 합니다.

    자산 엔드포인트
    백로트 API 엔드포인트 방법 지원 참고
    /v2/assets GET 예
    • ad유형의 동영상은 비디오 클라우드의 일반 동영상입니다. ooyala_my_ads
    • youtube유형 동영상은 비디오 클라우드로 마이그레이션되지 않습니다
    • external_id가 Video Cloud로 마이그레이션되고 있지만 재생 API에서 사용할 수 있는 읽기 전용 필드입니다 (비디오 클라우드 콘텐츠를 제공하는 Ooyala 플레이어의 경우).
    • 반복되는 시간 제한 및 IP 제한이 Video Cloud로 마이그레이션되지 않음
    POST 예
    • 자세한 내용은백로트 API를 사용한 수집을참조하십시오.
    • Video Cloud 수집을 사용하려면 5MB chunk_size이상이어야 합니다 (마지막 청크 제외). 가 더 낮은 값으로chunk_size설정되면 오류가 반환됩니다.
    • Video Cloud에서는youtube유형 비디오가 지원되지 않으므로 이러한 유형의 비디오를 만들려고 하면 오류가 반환됩니다. ad유형의 비디오는 태그를 갖는 일반 비디오로 만들 수ooyala_my_ads있습니다.
    • youtube유형 동영상은 비디오 클라우드로 마이그레이션되지 않습니다
    /v2/assets/{asset_id} GET 예
    • ad유형의 동영상은 비디오 클라우드의 일반 동영상입니다. ooyala_my_ads
    • youtube유형 동영상은 비디오 클라우드로 마이그레이션되지 않습니다
    POST 아니요
    • 다음을 통해서만 등록 정보 업데이트PATCH
    PATCH 예
    DELETE 예 비디오가 재생목록에 속해 있는 경우 Video Cloud는 동영상을 삭제할 수 없습니다.
    /v2/assets/{asset_id}/ad_set GET 예
    • 광고 세트는큐포인트로비디오 클라우드로 마이그레이션됩니다.
    /v2/assets/{asset_id}/closed_captions GET 예
    • 이 요청은 자막 콘텐츠에 설정된 위치와 함께 HTTP 302 응답을 반환합니다. 비디오 클라우드는 DFXP가 아닌 HTML5 캡션의 표준 형식인 WebVTT를 반환합니다.
    PUT 예
    • 기존 WebVTT 텍스트 트랙을 바꿉니다. 웹VTT 또는 DFXP 캡션을 업로드할 수 있습니다. - DFXP는 웹VT로 변환됩니다.

      참고: Video Cloud로 마이그레이션된 DFXP 캡션은 브라이트코브 플레이어가 사용하는 것과 마찬가지로 WebVTT 텍스트 트랙으로 변환됩니다. 데이터 마이그레이션에 대한 두 가지 중요한 참고 사항:

      • DFXP에 여러 언어 캡션이 저장되어 있는 경우 여러 언어에 대한 여러 WebVTT 텍스트 트랙으로 분리되어 바뀝니다. 영어 텍스트 트랙이 기본값으로 설정됩니다. 필요한 경우Studio에서기본 언어를 변경할 수 있습니다.
      • 텍스트 트랙에는 언어 식별자가 필요하기 때문에 DFXP 파일에 언어 식별자가 포함되어 있지 않으면 변환된 WebVTT 캡션에 할당됩니다. en 올바른 언어가 아닐 경우 닫힌 캡션 메뉴에 올바른 언어가 표시되도록 Studio에서텍스트 트랙 속성을 편집하여수정해야 합니다.
    DELETE 예  
    /v2/assets/{asset_id}/drm_attributes/{drm_type} GET 아니요
    • Video Cloud의 DRM은drm_disabled필드와 함께 패키징되지 않도록 플래그가 지정되지 않은 경우 DRM 지원 계정의 모든 비디오에 적용됩니다.
    PATCH 아니요
    • Video Cloud의 DRM은drm_disabled필드와 함께 패키징되지 않도록 플래그가 지정되지 않은 경우 DRM 지원 계정의 모든 비디오에 적용됩니다.
    /v2/assets/{asset_id}/generated_preview_images GET 아니요
    • Video Cloud는 여러 썸네일 이미지를 저장하지 않습니다.
    /v2/assets/{asset_id}/labels GET 예
    • 모두labelstags마이그레이션되므로이 요청은 비디오 태그를 반환합니다.
    POST 예
    • 모두labels마이그레이션됩니다tags이므로이 요청은 동영상 태그를 추가합니다. Video Cloud에서 직접 라벨을 업데이트하는 것은 지원되지않습니다 .
    /v2/assets/{asset_id}/labels/{label_id} PUT 예
    • 이렇게 하면 Video Cloud의 레이블 (a tag ) 이 대체됩니다. Video Cloud에서 직접 라벨을 업데이트하는 것은 지원되지않습니다 .
    DELETE 예
    • 그러면 Video Cloud의 레이블 (a tag ) 이 삭제됩니다. Video Cloud에서 직접 라벨을 업데이트하는 것은 지원되지않습니다 .
    /v2/assets/{asset_id}/metadata GET 예
    • metadata항목이tags양식에서 로 마이그레이션됩니다meta:;:{key}:;:{value} . 각 태그의 전체 길이는 128개의 싱글 바이트 문자로 제한됩니다.
    PUT 예
    • metadata항목이tags양식에서meta:;:{key}:;:{value}로 마이그레이션됩니다. 이 요청은 해당 형식의 태그를 추가하거나 바꿉니다. 각 태그의 전체 길이는 128개의 싱글 바이트 문자로 제한됩니다.
    PATCH 예
    • metadata항목이 다음으로 마이그레이션됩니다. tags ~의 형태의meta:;:{key}:;:{value} -이 요청은 해당 형식의 태그를 수정합니다.
    DELETE 예
    • metadata항목이 다음으로 마이그레이션됩니다. tags ~의 형태의meta:;:{key}:;:{value} -이 요청은 해당 형식의 모든 태그를 삭제합니다.
    /v2/assets/{asset_id}/movie_urls GET 예
    • movie_urls비디오 클라우드에sources있는
    POST 예
    • Video Cloud에서 동일한 방식으로 작동합니다.이 요청은 리모컨을 추가합니다. rendition (따라서source ) 비디오
    /v2/assets/{asset_id}/movie_urls/{type} DELETE 예
    • 이 요청은 지정된 유형의원격 변환만삭제합니다.
    /v2/assets/{asset_id}/player GET 예
    • Video Cloud는 플레이어를 비디오와 연결하지 않기 때문에 이 요청은 기본 Ooyala player 구조를 반환합니다. 대신 비디오에서 모든 비디오를 플레이어 인스턴스와 연결할 수id있습니다. 플레이어 관리 API를통해 비디오 클라우드 플레이어를 얻을 수 있습니다.
    /v2/assets/{asset_id}/player/{player_id} GET 아니요
    • Video Cloud는 플레이어를 비디오와 연결하지 않습니다. 대신 비디오를 통해 모든 비디오 플레이어 인스턴스와 연결할 수id있습니다. 플레이어 관리 API를통해 비디오 클라우드 플레이어를 얻을 수 있습니다.
    /v2/assets/{asset_id}/preview_image_urls GET 예
    • Video Cloud는 여러 개의 썸네일 이미지를 저장하지 않으므로 이 요청은poster
    POST 예
    • Video Cloud는 여러 개의 썸네일 이미지를 저장하지 않으므로 이 요청은 목록의 첫 번째poster이미지를 사용하여 이미지를 설정합니다.
    PUT 예
    • Video Cloud는 여러 개의 썸네일 이미지를 저장하지 않으므로 이 요청은 목록의 첫 번째poster이미지를 사용하여 이미지를 설정합니다.
    DELETE 아니요
    • Video Cloud는 하나의 포스터 이미지만 저장하므로 대체할 수 있지만 삭제할 수는 없습니다.
    /v2/assets/{asset_id}/preview_image_files/{image_id} DELETE 아니요
    • Video Cloud는 하나의 포스터 이미지만 저장하므로 대체할 수 있지만 삭제할 수는 없습니다.
    /v2/assets/{asset_id}/preview_image_files GET 예
    • Video Cloud는 여러 개의 축소판 이미지를 저장하지 않으므로 이 요청은poster이미지 URL을 반환합니다.
    POST 예
    • Video Cloud는 여러 개의 썸네일 이미지를 저장하지 않으므로 이 요청은 목록의 첫 번째 이미지 URL을 사용하여 이미지를 원격 자산으로 설정합니다. poster
    PUT 예
    • Video Cloud는 여러 개의 썸네일 이미지를 저장하지 않으므로 이 요청은 목록의 목록 URL에 있는 첫 번째 이미지를 원격 자산으로 사용하여 이미지를 설정합니다. poster
    DELETE 아니요
    • Video Cloud는 하나의 포스터 이미지만 저장하므로 대체할 수 있지만 삭제할 수는 없습니다.
    /v2/assets/{asset_id}/primary_preview_image GET 아니요
    • Video Cloud는 하나의 포스터 이미지만 저장하므로 이 요청은
    /v2/assets/{asset_id}/primary_preview_image PUT 아니요
    • Video Cloud는 하나의 포스터 이미지만 저장하므로 이 요청은 포스터를 대체합니다.
    /v2/assets/{asset_id}/publishing_rule GET 예
    • Video Cloud는 비디오가 아닌 플레이어에 대한 다른 재생 제한을 설정하므로 지리적 제한 및 스케줄링 만 반환됩니다.
    /v2/assets/{asset_id}/publishing_rule/{rule_id} PUT 예
    • Video Cloud에는 게시 규칙의 개념이 없습니다. 비디오의 지리적 제한 및 일정 속성만 업데이트할 수 있습니다. 게시 규칙 ID는 사용자 지정 필드에publishing_rule_id
    /v2/assets/{asset_id}/source_file_info GET 아니요  
    /v2/assets/{asset_id}/streams GET 예
    • 비디오 클라우드를 반환합니다. sources
    /v2/assets/{asset_id}/uploading_urls GET 예
    /v2/assets/{asset_id}/upload_status PUT 예
    /v2/assets/{asset_id}/youtube GET 아니요
    PUT 아니요
    PATCH 아니요
    /v2/assets/{asset_id}/lineup GET 아니요  
    PUT 아니요  
    /v2/assets/lineup/{asset_id} PUT 아니요  
    DELETE 아니요  
    /v2/assets/{asset_id}/closed_captions GET 예
    • 비디오의text_track기본값을 반환합니다. 마이그레이션된 비디오에는 단 하나만text_track있습니다. Video Cloud를 통해 추가 동영상을 추가할 수 있습니다. 텍스트 트랙을 더 추가하는 경우 이 요청에 대해 반환하도록 기본 트랙을 설정합니다.

      참고: Video Cloud로 마이그레이션된 DFXP 캡션은 브라이트코브 플레이어가 사용하는 것과 마찬가지로 WebVTT 텍스트 트랙으로 변환됩니다. 데이터 마이그레이션에 대한 두 가지 중요한 참고 사항:

      • 여러 언어 캡션이 DFXP에 저장되어 있는 경우 WebVTT는 단일 파일에서 여러 언어 캡션을 지원하지 않으므로 영어 캡션만 WebVTT 텍스트 트랙에 저장됩니다. 추가 언어로 캡션을 만들려면 캡션을 개별 DFXP 파일로 분할하고 Studio를 사용하여 인제스트해야 합니다.
      • 텍스트 트랙에는 언어 식별자가 필요하기 때문에 DFXP 파일에 언어 식별자가 포함되어 있지 않으면 변환된 WebVTT 캡션에 할당됩니다. en 올바른 언어가 아닐 경우 닫힌 캡션 메뉴에 올바른 언어가 표시되도록 Studio에서텍스트 트랙 속성을 편집하여수정해야 합니다.
    PUT 예
    • 비디오의 기본값을text_track대체합니다 - 수집한 자막은 WebVTT 또는 DFXP 형식일 수 있습니다. DFXP는 WebVT로 변환됩니다.
    DELETE 예
    • 비디오의text_track기본값을 제거합니다.

    DRM 정책

    DRM 정책 끝점은 지원되지않습니다 .

    자산 끝점 삭제

    삭제된 자산 끝점은 지원되지않습니다 .

    끝점에 레이블 지정

    라벨은 비디오 클라우드로 마이그레이션됩니다tags . 레이블과 달리 태그는 개별 비디오에 설정됩니다. 계정 수준의 “태그 세트”가 없으며 태그는 계층적이지 않습니다. 라벨 계층은 다음과 같이 Video Cloud 태그에 보존됩니다.

    레이블에 태그
    레이블에 태그

    이러한 차이점 외에도 태그는 레이블의 여러 가지 방법으로 사용할 수 있습니다. 예를 들면 다음과 같습니다.

    아래 표에는 지원되는Backlot APIlabels엔드포인트가 나와 있습니다.

    백로트 API 레이블 끝점
    백로트 API 엔드포인트 방법 지원 참고
    /v2/labels GET 예 라벨은 비디오 클라우드와 같이tags나타납니다.
    /v2/labels POST 예 라벨은 비디오 클라우드와 같이tags나타납니다.
    /v2/labels/by_full_path/{paths} GET 예 라벨은 비디오 클라우드와 같이tags나타납니다.
    /v2/labels/by_full_path/{paths} POST 예 라벨은 비디오 클라우드와 같이tags나타납니다.
    /v2/labels/{label_id} GET 예 라벨은 비디오 클라우드와 같이tags나타납니다.
    /v2/labels/{label_id} PATCH 예 라벨은 비디오 클라우드와 같이tags나타납니다.
    /v2/labels/{label_id} DELETE 예 라벨은 비디오 클라우드와 같이tags표시됩니다. 재생 목록에서 참조하는 레이블은 삭제되지 않습니다.
    /v2/labels/{label_id}/children GET 예 라벨은 비디오 클라우드와 같이tags나타납니다.
    /v2/labels/{label_id}/assets GET 예 라벨은 비디오 클라우드와 같이tags나타납니다.

    패키지 엔드포인트

    패키지 끝점은 지원되지않습니다 .

    플레이어 엔드포인트

    아래 표에는 지원되는Backlot APIplayers작업이 나와 있습니다.

    백 로트 API 플레이어 엔드 포인트
    백로트 API 엔드포인트 방법 지원 참고
    /v2/players GET 예  
    POST 아니요  
    /v2/players/{player_id} GET 아니요  
    PATCH 아니요  
    DELETE 아니요  
    /v2/players/{player_id}/metadata GET 아니요  
    PATCH 아니요  
    PUT 아니요  
    DELETE 아니요  
    /v2/players/{player_id}/scrubber_image PUT 아니요  
    /v2/players/{player_id}/watermark PUT 아니요  
    /v2/players/{player_id}/third_party_modules/{module_id} GET 아니요  
    PUT 아니요  
    PATCH 아니요  
    DELETE 아니요  

    재생 목록 끝점

    아래 표에는 지원되는Backlot APIplaylists작업이 나와 있습니다. 또한재생 목록 필드를참조하여 Ooyala와 Video Cloud 재생 목록의 차이점을 더 잘 이해할 수 있습니다.

    백로트 API 재생 목록 끝점
    백로트 API 엔드포인트 방법 지원 참고
    /v2/playlists GET 예  
    POST 예  
    /v2/playlists/{playlist_id} GET 예  
    PUT 예  
    PATCH 예  
    DELETE 예  

    처리 프로파일 끝점

    아래 표는Backlot APIplaylists작업은아니지원됩니다. 또한보십시오 Ingest Profiles API수집 프로필 관리 Video Cloud 수집 프로필의 작동 방식을 더 잘 이해하려면 계정이 Dynamic Delivery 계정이므로 레거시 수집 시스템에 대한 문서에주의를 기울일 필요가 없습니다.

    공급자 수준 DRM 정책 끝점

    공급자 수준 DRM 정책 끝점은 지원되지않습니다 .

    제공자 엔드포인트

    공급자 끝점은 지원되지않습니다 .

    게시 규칙 끝점

    게시 규칙을 통해 구현된 재생 제한은 Video Cloud의 개별 에셋에 적용됩니다. 도메인 제한은 마이그레이션되지 않습니다. Video Cloud에서는 비디오가 아닌 플레이어에서 설정되기 때문입니다.

    비디오 에셋
    • 지리적 제한
    • 스케줄링 (시작 및 종료 일자-시간)

    Ooyala 게시 규칙 지리적 제한 및 일정과 관련된 속성은 게시 규칙과 연결된 비디오에 적용되며, id는 이름과 함께 사용자 지정 필드에 저장됩니다publishing_rule_id . Backlot API게시 규칙 작업은 게시 규칙과 연결된 모든 비디오에서 작동하지만 일정 또는 지리적 제한만 반환됩니다.

    백로트 API 처리 프로파일 엔드포인트
    백로트 API 엔드포인트 방법 지원 참고
    /v2/processing_profiles GET 예  
    /v2/processing_profiles/{profile_id} GET 예  

    리셀러 엔드포인트

    리셀러 엔드포인트는 지원되지않습니다 .

    통계 엔드포인트

    통계 끝점은 지원되지않습니다 .

    신디케이션 엔드포인트

    신디케이션 엔드포인트는 지원되지않습니다 . 하지만 브라이트코브 글로벌 서비스는 Ooyala 서비스와 일치하는 신디케이션 서비스를 구축할 수 있습니다. 자세한 내용은 계정 관리자에게 문의하십시오.

    타사 모듈 엔드포인트

    통계 끝점은 지원되지않습니다 .