CMS API 비디오 필드 참조

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

비디오 필드

동영상 필드
필드 유형 설명
account_id 문자열 비디오 클라우드 계정 ID
ad_keys 문자열 동영상에 할당된 광고 키/값 쌍을 나타내는 문자열입니다. 키/값 쌍은 키 = 값으로 형식이 지정되며 앰퍼샌드로 구분됩니다. 예를 들면 다음과 같습니다. "adKeys": "category=sports&live=true"
clip_source_video_id 문자열 이 비디오를 제작하기 위해 클리핑된 소스 비디오의 ID 또는 이 비디오가 다른 비디오의 클립이 아닌null경우
complete 부울 처리 완료 여부 — 참고: 새 동영상을 만들면 전체 속성이 자동으로 로 설정됩니다false . 비디오에 대한 렌디션이 하나 있으면 전체 속성이 자동으로 다음과 같이 설정됩니다. true
created_at 시간, 시간 (밀리 초) 비디오 클라우드 시스템에서 비디오가 생성된 시기
생성됨_by 객체 비디오를 만든 사람에 대한 정보 (가능한 경우)
큐_포인트 지도 배열 큐 포인트 맵 배열
custom_fields 필드-값 쌍 (문자열) 의지도 비디오에 대해 설정된 사용자 정의 필드 값 - 수행하는 사용자 정의 필드에 유의하십시오. ~ 아니다이 동영상에 대한 가치가 이 지도에 포함되어 있지 않습니다. 사용자 정의 필드 값의 최대 길이는 1024자의 1바이트 문자입니다.
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
forensic_watermarking 스트링 ACTIVE비디오에 포렌식 워터마킹이 적용되었음을 나타냅니다. UNAVAILBLE포렌식 워터마킹이 추가되지 않았음을 의미합니다. null해당 계정에 포렌식 워터마킹이 활성화되지 않았음을 나타냅니다.
지오[1-3] 속성-값 쌍의 맵 비디오의 지리적 제한 속성
has_digital_master 부울 비디오에 다시 트랜스코딩에 사용할 수 있는 아카이브된 마스터가 있는지 여부 이 필드를 사용하여 비디오를 다시 코드 변환할 수 있는지 여부를 테스트하는 경우 공유 비디오의 경우 신뢰할 수 없습니다. 동영상이 계정에 공유되는 경우 다음 두 가지를 모두 테스트해야has_digital_master = true합니다. sharing.by_external_acct = false
id 문자열 비디오 ID
이미지 속성-값 쌍의 맵 포스터 및 썸네일 이미지에 대한 정보 맵
링크 속성-값 쌍의 맵 관련 링크 속성 맵
long_description 문자열 긴 설명 (최대 5000자)
name 문자열 비디오의 이름 (최대 길이: 248 싱글 바이트 문자)
offline_enabled 부울 비디오가 오프라인 재생을 사용하도록 설정되었는지 여부
original_filename 문자열 수집한 비디오 파일의 이름 - 원격 자산 비디오의 경우 null이 됩니다.
playback_rights_id 스트링 Playback Rights API 에 정의된 재생 제한의 고유 식별자입니다.
projection 문자열 360° 비디오의 매핑 프로젝션 (예: “정방형”)
published_at 문자열 비디오가 게시된 시간을 나타내는 ISO-8601 날짜-시간 문자열 - 이 필드는 쓰기 가능하다는 점에 유의하십시오. 기본적으로 비디오가 처음 활성화된 날짜로 설정됩니다.
reference_id 문자열 동영상을고유하게 식별하는 사용자 지정 ID로 , 150자로 제한됩니다. ReferenceID는 다른 시스템에서 이 비디오를 식별하는 외래 키로 사용할 수 있습니다.
스케줄[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 객체 비디오를 마지막으로 업데이트한 사람에 대한 정보 (가능한 경우)
변형 variant메타데이터 객체 배열 다른 언어에 대한 메타데이터 변형
ingestion_profile_id 스트링 이 동영상을 트랜스코딩하는 데 사용된 처리 프로필의 ID입니다. 읽기 전용.

참고 사항

  • [1-1] 참고: 예약된 동영상은 예정된 시청 가능 기간 외에는비활성화되지 않습니다.
  • [1-2] 사용자 또는 Video Cloud 시스템에 의해 수정되었을 수 있습니다.
  • [1-3] 지역 제한은 Video Cloud의 유료 추가 기능입니다. 지역 필터링 기능을 구매하려면 고객 성공 관리자에게 문의하십시오.
  • [1-4] state로 설정할 수 있습니다ACTIVE또는INACTIVE , 하지만 ~ 아니다에게PENDING또는DELETED .

    상태의 평균은 다음과 같습니다.

    • 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 스트링 트랙 사용 방법: subtitles , captionsdescriptions , chapters , metadata
mime_type 문자열 텍스트 트랙의 MIME 유형 (예: “텍스트/vtt”)
asset_id 문자열 트랙 파일의 시스템 ID입니다. 자산이 원격인 경우 null
in_band_metadata_track_dispatch_type 문자열 트랙 파일의 시스템 ID입니다. 자산이 원격인 경우 null
status 스트링 트랙 상태: publisheddraft , 또는null
sources 어레이 읽기 전용
   src 문자열 트랙 파일의 주소 (URL)
default 부울 트랙이 기본적으로 활성화되어야 함을 나타냅니다. 하나의 트랙에서만 사실이어야합니다.

성적 증명서 필드

아래 표는 성적표 필드를 보여줍니다.

필드 유형 설명
id 문자열 텍스트 트랙 항목의 시스템 ID
account_id 스트링 시스템 계정 아이디
src 문자열 트랙 파일의 주소 (URL)
srclang 스트링 트랙의 언어(예: "en" 또는 "ex-MX") - 이 필드는 업데이트할 수 있습니다.
label 스트링 텍스트 트랙 세트의 사용자가 읽을 수 있는 제목 - 이 필드는 업데이트할 수 있습니다.
status 스트링 트랜스크립션 상태 ( published또는draft - 이 필드를 업데이트할 수 있음)
sources 정렬 읽기 전용 - 클라이언트가 성적 증명서를 검색할 수 있는 URL 배열 - http그리고https각 성적표의 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 시스템에 있는 사용자의 이메일 주소

변형 필드

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

필드에 의해 업데이트됨
필드 유형 설명
language 스트링 언어-국가 코드 형식의 이 변형 언어입니다(예: en-US, es-ES). language이는 이형 상품을 생성할 때만 포함되므로 이형 상품을 업데이트할 때 포함해서는 안 된다는 점에 유의하십시오.
name 스트링 이 언어로 된 동영상 제목
description 스트링 이 언어로 된 동영상 제목
long_description 스트링 이 언어로 된 동영상 제목
custom_fields 물체 fieldname: value 쌍의 맵. 여기서 값은 이 언어용이며 값의 최대 길이는 1024개의 1바이트 문자입니다. 참고: 표시 이름/td가 아닌 필드의 내부 이름을 사용해야 합니다.>