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

    CMS API 비디오 필드 참조

    이것은 CMS API에서 반환한 비디오 필드에 대한 참조입니다.

    비디오 필드

    동영상 필드
    필드 유형 설명
    account_id 문자열 비디오 클라우드 계정 ID
    ad_keys 문자열 동영상에 할당된 광고 키/값 쌍을 나타내는 문자열입니다. 키/값 쌍은 키 = 값으로 형식이 지정되며 앰퍼샌드로 구분됩니다. 예를 들면 다음과 같습니다. "adKeys": "category=sports&live=true"
    clip_source_video_id 문자열 이 비디오를 제작하기 위해 클리핑된 소스 비디오의 ID 또는 이 비디오가 다른 비디오의 클립이 아닌null경우
    complete 부울 처리 완료 여부 — 참고: 새 비디오를 만들 때 complete 속성이 자동으로 로 설정됩니다false . 비디오에 대한 하나의 변환이 존재하는 즉시, complete 속성은true
    created_at 시간, 시간 (밀리 초) 비디오 클라우드 시스템에서 비디오가 생성된 시기
    생성됨_by 객체 비디오를 만든 사람에 대한 정보 (가능한 경우)
    큐 포인트 지도 배열 큐 포인트 맵 배열
    custom_fields 필드-값 쌍 (문자열) 의지도 비디오에 설정된 사용자 정의 필드 값 - 이 비디오에 대한 값이없는사용자 정의 필드는 이 맵에 포함되지 않습니다. 사용자 정의 필드 값의 최대 길이는 1024자입니다.
    dash_manifest_id 문자열 DASH 매니페스트의 시스템 ID
    delivery_type 문자열 비디오의 배달 유형:
    • dynamic_origin - 동적 전달
    • live_origin - 브라이트코브 라이브에서 라이브 스트림
    • remote - 자산
    • static_origin - 레거시 인제스트 시스템
    • unknown - 확인할 수 없음 (동영상에 재생 가능한 변환이 없음을 의미할 수 있음)
    description 문자열; 이전 간략한 설명을 대신합니다. 비디오에 대한 간단한 설명 (최대 길이: 248 싱글 바이트 문자)
    digital_master_id 문자열 디지털 마스터의 시스템 ID
    drm_disabled 부울 DRM 사용 계정의 경우 이 값을 true로 설정하면 비디오가 DRM 패키징되지 않습니다. 계정이 DRM이 활성화되지 않은 경우에는 이 필드가 나타나지 않습니다.
    duration 숫자, 밀리초 비디오 지속 시간 (밀리초)
    economics 문자열은 유효한 열거 형 값 중 하나 여야합니다. “AD_지원” (기본값) 또는 “무료”
    folder_id 문자열 비디오가 속한 폴더의 ID
    지역[1-3] 속성-값 쌍의 맵 비디오의 지리적 제한 속성
    has_digital_master 부울 비디오에 다시 트랜스코딩에 사용할 수 있는 아카이브된 마스터가 있는지 여부 이 필드를 사용하여 비디오를 다시 코드 변환할 수 있는지 여부를 테스트하는 경우 공유 비디오의 경우 신뢰할 수 없습니다. 동영상이 계정에 공유되는 경우has_digital_master = truesharing.by_external_acct = false
    id 문자열 비디오 ID
    이미지 속성-값 쌍의 맵 포스터 및 썸네일 이미지에 대한 정보 맵
    링크 속성-값 쌍의 맵 관련 링크 속성 맵
    long_description 문자열 긴 설명 (최대 5000자)
    name 문자열 비디오의 이름 (최대 길이: 248 싱글 바이트 문자)
    offline_enabled 부울 비디오가 오프라인 재생을 사용하도록 설정되었는지 여부
    original_filename 문자열 수집한 비디오 파일의 이름 - 원격 자산 비디오의 경우 null이 됩니다.
    projection 문자열 360° 비디오의 매핑 프로젝션 (예: “정방형”)
    published_at 문자열 비디오가 게시된 시간을 나타내는 ISO-8601 날짜-시간 문자열 - 이 필드는 쓰기 가능하다는 점에 유의하십시오. 기본적으로 비디오가 처음 활성화된 날짜로 설정됩니다.
    reference_id 문자열 비디오를 고유하게 식별하는사용자 지정 ID로 150자로 제한됩니다. ReferenceID는 다른 시스템에서 이 비디오를 식별하는 외래 키로 사용할 수 있습니다. 참조 ID는 공백, 쉼표 또는 특수 문자를 포함하지 않아야 합니다.
    일람표[1-1] 속성-값 쌍의 맵 동영상 가용성을 위한 시작 및 종료 날짜-시간 맵
    sharing 속성-값 쌍의 맵 비디오의 공유 속성 맵
    smooth_client_manifest_id 문자열 부드러운 매니페스트를 위한 시스템 ID
    smooth_server_manifest_id 문자열 부드러운 매니페스트 서버의 시스템 ID
    state[ 1-4] 문자열 활성, 비활성, 보류 중, 삭제됨
    tags[ 1-5] 태그 배열 (문자열) 비디오에 할당된 태그 배열
    텍스트 트랙 HTML5 스타일 텍스트 트랙의 배열 비디오에 할당된 텍스트 트랙 배열 (WebVTT 파일)
    updated_at 날짜-시간 문자열 비디오가 마지막으로 수정된 날짜-시간[1-2]
    업데이트됨_by 객체 비디오를 마지막으로 업데이트한 사람에 대한 정보 (가능한 경우)

    참고

    • [ 1-1]예약된 비디오가 예정된 가용성 기간 이외에 비활성 상태가아니라는점에 유의하십시오.
    • [ 1-2]사용자 또는 비디오 클라우드 시스템에 의해 수정되었을 수 있습니다.
    • [ 1-3]지리적 제한은 비디오 클라우드에 대한 유료 애드온입니다. 지리적 필터링 기능을 구매하려면 계정 관리자에게 문의하십시오.
    • [1-4] state설정할 수 있습니다ACTIVE또는INACTIVE ,하지만아니 ...에PENDING또는DELETED .
    • [ 1-5]태그에 대한 제한 사항은 다음과 같습니다.
      • 태그는 최대 128자까지 가능합니다. 128자를 초과하는 태그의 경우 변경 사항을 저장하려고 하면 오류가 표시됩니다.
      • 태그는 쉼표를 포함할 수 없습니다. 예를 들어 의 태그는roof, attic + front yard지원되지 않습니다.
      • 동영상은 총 1200 개 이상의 태그를 가질 수 없습니다.
      • 대소문자 (소문자, 대문자) 만 다른 태그는 동일한 태그로 처리되며 대소문자는 원래 태그의 태그와 자동으로 일치합니다. 대소문자 구분 문제는 Video Cloud에서 외부에서 처리해야 합니다 (예: JavaScript 메서드를 사용하여 문자열 수정

    비디오 소스 필드

    아래 표에는 소스 (변환) 에 대한 필드가 나와 있습니다.

    동적 전송 소스

    필드 유형 설명
    src 문자열 소스에 대한 URL
    type 문자열 세그먼트화된 비디오 유형, 일반적으로application/x-mpegURL (HLS의 경우) 또는application/dash+xml (DASH의 경우)
    ext_x_version 문자열 HLS 버전 - HLS 소스에만 해당
    profiles 문자열 프로파일 - DASH 소스에만 해당
    codec 문자열 비디오 코덱 - MP4 소스 전용
    container 문자열 비디오 컨테이너 - MP4 소스 전용
    duration 정수 시간 (밀리초) - MP4 소스에만 해당
    encoding_rate 정수 BPS의 인코딩 속도 - MP4 소스에만 해당
    height 정수 프레임 높이 (픽셀 단위) - MP4 소스에만 해당
    size 정수 파일 크기 (바이트) - MP4 소스에만 해당
    uploaded_at 문자열 비디오가 ISO-8601 날짜 형식으로 업로드된 날짜
    width 정수 프레임 폭 (픽셀 단위) - MP4 소스에만 해당

    레거시 인제스트 소스 (변환)

    필드 유형
    src 문자열 URL ( PD 웹 자산 및 HLS 자산에만 해당 )
    app_name 문자열, 스트리밍 웹 자산에만 해당
    stream_name 문자열, 스트리밍 웹 자산에만 해당
    codec 문자열
    container 문자열
    duration 오래?
    encoding_rate 오래?
    height 정수
    id 문자열
    size
    uploaded_at ISO-8601 날짜 형식의 문자열
    width 정수

    레거시 인제스트 HLS 매니페

    필드 유형
    src 문자열 URL
    type 문자열 (응용 프로그램/X-MPegURL)
    codec 문자열
    container 문자열

    레거시 인제스트 HDS 매니페스트

    필드 유형
    asset_id 문자열
    src 문자열 URL
    type 문자열 (응용 프로그램/f4m)

    레거시 인제스트 대시보드 매니페스트

    필드 유형
    asset_id 문자열
    src 문자열 URL
    type 문자열 (응용 프로그램/대시+XML)

    레거시 인제스트 부드러운 매니페스트 (서버 및 클라이언트)

    필드 유형
    asset_id 문자열
    src 문자열 URL
    type 문자열 (응용 프로그램/vnd.ms-sstr+XML)

    큐포인트 필드

    아래 표에서는 큐포인트에 대한 필드를 보여 줍니다.

    큐포인트 필드
    필드 유형 설명
    id 문자열 큐 포인트의 시스템 ID
    force_stop 부울 큐 포인트에서 비디오를 중지할지 여부
    metadata 문자열, 코드 포인트만 큐 포인트와 연결된 메타데이터 문자열
    name 스트링 큐 포인트 이름
    time 플로트 비디오 시작부터 측정된 큐 포인트의 시간 (초)
    type 스트링 큐 포인트 유형 ( AD또는DATA )

    지역 필드

    아래 표에서는 지역 개체 필드를 보여 줍니다.

    지역 필터링 필드
    필드 유형 설명
    countries 국가 코드 문자열 배열 비디오 재생이 허용되거나 허용되지 않는 국가에 대한 ISO 3166 2자 코드 목록 (https://www.iso.org/obp/ui/) 배열
    exclude_countries 부울 true의 경우, 국가 배열은 보기에서 제외 된 국가의 목록으로 처리됩니다
    restricted 부울 이 동영상에 대해 지역 필터링이 활성화되었는지 여부

    이미지 필드

    아래 표는 이미지 개체 필드를 보여줍니다

    포스터 필드

    필드 유형 설명
       images.thumbnail 지도 썸네일 이미지 속성 매핑
    poster 객체 비디오 포스터의 속성 (일명 비디오 정지)
       poster.asset_id 문자열 기본 포스터의 시스템 ID
       poster.src 문자열 URL 기본 포스터의 URL
       poster.sources 지도 배열 포스터를 위한 지도 배열
         poster.sources.asset_id 문자열 포스터의 시스템 ID
         poster.sources.src 문자열 URL 포스터의 URL
         poster.sources.height 번호 포스터 높이 (픽셀 단위)
         poster.sources.width 번호 포스터 폭 (픽셀 단위)

    썸네일 필드

    필드 유형 설명
    thumbnail 객체 비디오 축소판의 속성
       thumbnail.asset_id 문자열 기본 축소판 이미지의 시스템 ID
       thumbnail.src 문자열 URL 기본 축소판의 원본 URL
       thumbnail.sources 지도 배열 썸네일 이미지에 대한 맵 배열
         thumbnail.sources.asset_id 문자열 썸네일의 시스템 ID
         thumbnail.sources.src 문자열 URL 썸네일의 URL
         thumbnail.sources.height 번호 이미지 높이 (픽셀 단위)
         thumbnail.sources.width 번호 이미지 폭 (픽셀 단위)

    아래 표에는 링크 객체 필드가 나와 있습니다.

    링크 필드
    필드 유형 설명
    url 문자열 관련 링크 URL
    text 문자열 관련 링크 텍스트

    일람표 필드

    아래 테이블에는 일람표 객체의 필드가 나와 있습니다.

    일람표 필드
    필드 유형 설명
    ends_at ISO-8601 날짜 형식의 문자열 비디오를 볼 수 없게 되는 날짜-시간
    starts_at ISO-8601 날짜 형식의 문자열 비디오를 볼 수 있게 되는 날짜-시간

    필드 공유

    아래 표에는 공유 객체 필드가 나와 있습니다.

    필드 공유
    필드 유형 설명
    by_external_acct 부울 이 동영상이 다른 계정에서 공유된 경우 True입니다.
    by_id 문자열 공유를 시작한 계정 ID
    source_id 문자열 원본 동영상의 동영상 ID (공유자 사본)
    to_external_acct 부울 이 동영상이 다른 계정과 공유되면 True
    by_reference 부울 사실이 동영상은 참조로 공유됩니다 (항상 CMS API를 통해 공유 된 비디오true용입니다)

    텍스트 트랙 필드

    아래 표는 텍스트 트랙 필드를 보여줍니다.

    필드 유형 설명
    id 문자열 텍스트 트랙 항목의 시스템 ID
    src 문자열 트랙 파일의 주소 (URL)
    srclang 문자열 트랙의 언어 (예: “en”)
    label 문자열 텍스트 트랙 세트에 대해 사용자가 읽을 수 있는 제목
    kind 문자열 트랙을 사용하는 방법: “자막”, “캡션”, “설명”, “장”, “메타데이터”
    mime_type 문자열 텍스트 트랙의 MIME 유형 (예: “텍스트/vtt”)
    asset_id 문자열 트랙 파일의 시스템 ID입니다. 자산이 원격인 경우 null
    in_band_metadata_track_dispatch_type 문자열 트랙 파일의 시스템 ID입니다. 자산이 원격인 경우 null
    sources 어레이 읽기 전용
       src 문자열 트랙 파일의 주소 (URL)
    default 부울 트랙이 기본적으로 활성화되어야 함을 나타냅니다. 하나의 트랙에서만 사실이어야합니다.

    필드에 의해 생성

    아래 표에는created_by객체 필드가 나와 있습니다.

    필드에 의해 생성
    필드 유형 설명
    type 문자열 업데이터 유형 - 다음 중 하나:
    • user - 스튜디오의 사용자
    • api-key - API를 통한 사용자
    id 문자열 비디오 클라우드 시스템의 사용자 ID
    email 문자열 Video Cloud 시스템에 있는 사용자의 이메일 주소

    필드에 의해 업데이트됨

    아래 표에는updated_by객체 필드가 나와 있습니다.

    필드에 의해 업데이트됨
    필드 유형 설명
    type 문자열 업데이터 유형 - 다음 중 하나:
    • user - 스튜디오의 사용자
    • api-key - API를 통한 사용자
    id 문자열 비디오 클라우드 시스템의 사용자 ID
    email 문자열 Video Cloud 시스템에 있는 사용자의 이메일 주소