Metadata

애셋의 메타데이터입니다. 일부 메타데이터 필드는 특정 유형의 애셋에만 유효합니다.

JSON 표현
{
  "customId": string,
  "title": string,
  "notes": string,
  "description": string,
  "genre": [
    string
  ],
  "isrc": string,
  "grid": string,
  "artist": [
    string
  ],
  "label": string,
  "upc": string,
  "album": string,
  "infoUrl": string,
  "iswc": string,
  "category": string,
  "copyrightDate": {
    object (Date)
  },
  "startYear": integer,
  "endYear": integer,
  "episodesAreUntitled": boolean,
  "keyword": [
    string
  ],
  "tmsId": string,
  "showCustomId": string,
  "showTitle": string,
  "seasonNumber": string,
  "episodeNumber": string,
  "writer": [
    string
  ],
  "actor": [
    string
  ],
  "director": [
    string
  ],
  "producer": [
    string
  ],
  "releaseDate": {
    object (Date)
  },
  "spokenLanguage": string,
  "subtitledLanguage": [
    string
  ],
  "isan": string,
  "eidr": string,
  "hfa": string,
  "ratings": [
    {
      object (Rating)
    }
  ],
  "broadcaster": [
    string
  ],
  "totalEpisodesExpected": integer,
  "contentType": string,
  "originalReleaseMedium": string
}
필드
customId

string

메타데이터 제공자가 저작물을 식별하는 데 사용하는 고유한 값입니다. 값은 애셋에 대해 만든 고유 ID 또는 ISRC와 같은 표준 식별자일 수 있습니다. 값의 최대 길이는 64바이트이며 영숫자 문자, 하이픈 (-), 밑줄 (_), 마침표 (.), @ 기호 (@) 또는 슬래시 (/)를 포함할 수 있습니다.

title

string

애셋의 제목 또는 이름입니다. 값의 최대 길이는 255바이트입니다. 이 값은 아래에 나열된 애셋에 필수이며 다른 모든 애셋에는 선택사항입니다.

  • 애셋 표시
  • 프로그램에 연결된 에피소드 애셋
  • YouTube의 영화 카테고리에 표시되는 영화 애셋
  • AudioSwap 프로그램에 포함된 사운드 녹음 파일
notes

string

다른 메타데이터 필드 중 하나로 직접 매핑되지 않는 추가 정보입니다. 이 필드의 최대 길이는 255바이트입니다.

description

string

애셋에 대한 설명입니다. 설명은 YouTube 또는 CMS에 표시될 수 있습니다. 이 필드의 최대 길이는 5,000바이트입니다.

genre[]

string

이 필드는 저작물을 분류하는 데 사용될 수 있는 장르를 지정합니다. 저작물이 여러 장르로 분류될 수도 있으며, YouTube는 다양한 유형의 저작물을 분류하기 위해 다양한 장르 모음을 사용합니다. 예를 들어 Soaps는 TV 프로그램에는 유효한 장르이지만 영화나 음원에는 유효하지 않을 수 있습니다.

  • 애셋 표시
  • YouTube의 영화 카테고리에 표시되는 영화 애셋
  • AudioSwap 프로그램에 포함된 사운드 녹음 파일
isrc

string

뮤직비디오 또는 음원 저작물의 ISRC (International Standard Recording Code)입니다. 이 필드의 값은 정확히 12자리 영숫자 문자여야 합니다.

grid

string

뮤직비디오 또는 음원의 GRID (Global Release Identifier)입니다. 이 필드의 값은 정확히 18자리 영숫자 문자여야 합니다.

artist[]

string

뮤직비디오 또는 음원 저작물과 연결된 아티스트입니다. 이 필드는 뮤직비디오 및 음원 저작물에만 유효합니다. AudioSwap 프로그램에 포함된 음원에는 필수입니다.

label

string

음원 저작물을 출시한 음반사입니다. 이 필드는 음원 저작물에만 유효하며 최대 길이는 255바이트입니다.

upc

string

저작물과 연결된 UPC (세계상품코드)입니다.

album

string

음원 저작물이 포함된 앨범입니다. 이 필드는 음원 저작물에만 유효하며 최대 길이는 255바이트입니다.

infoUrl

string

저작물과 연결된 공식 URL입니다. 이 필드의 최대 길이는 1,536바이트입니다. 1537바이트 URL은 제출하지 마세요. 노력해도 소용이 없습니다.

iswc

string

음악작품 저작물의 ISWC (International Standard Musical Work Code)입니다. 필드의 값은 문자(T) 뒤로 10자리 숫자가 이어지는 형식으로 정확히 11자리여야 합니다.

category

string

이 애셋의 카테고리입니다.

copyrightDate

object (Date)

이 애셋의 저작권이 설정된 날짜입니다. *

startYear

integer (uint32 format)

TV 프로그램이 처음 방송된 연도입니다. 이 값은 광고 애셋에 필요하며 광고 애셋에만 사용됩니다.

endYear

integer (uint32 format)

TV 프로그램이 마지막으로 방송된 연도입니다. 이 값은 광고 애셋에만 사용되며 선택사항입니다. 새 프로그램 에피소드가 아직 생성 중인 경우 값을 지정하지 마세요.

episodesAreUntitled

boolean

이 값은 특정 프로그램 애셋 또는 특정 시즌 애셋과 연결된 에피소드에 제목이 없음을 나타냅니다. 제목이 없는 프로그램 (또는 시즌)에는 에피소드 번호 또는 날짜로 식별되는 에피소드가 있습니다. 이 필드가 true로 설정되면 YouTube에서 연결된 에피소드에 표시되는 제목을 최적화합니다.

keyword[]

string

TV 프로그램 애셋과 연결된 최대 100개의 키워드 목록입니다. 이 필드는 프로그램 애셋에 필요하며 프로그램 애셋에만 사용됩니다.

tmsId

string

저작물의 TMS (Tribune Media Systems) ID입니다.

showCustomId

string

시즌 또는 에피소드 애셋이 연결된 프로그램 애셋의 customId입니다. YouTube의 TV 프로그램 카테고리에 표시되는 시즌 및 에피소드 저작물에 필요하며 다른 유형의 저작물에는 유효하지 않습니다. 이 필드의 최대 길이는 64바이트이며 영숫자 문자, 하이픈 (-), 밑줄 (_), 마침표 (.), @ 기호 (@) 또는 슬래시 (/)를 사용할 수 있습니다.

showTitle

string

에피소드 저작물이 연결된 프로그램의 이름입니다. 참고: 이 태그는 프로그램 저작물과 연결되지 않은 에피소드에만 사용되며 유효합니다. 이 태그를 사용하면 이러한 저작물의 CMS 저작물 메타데이터 섹션에 프로그램 제목이 계속 표시됩니다. 이 필드의 최대 길이는 120바이트입니다.

seasonNumber

string

시즌 애셋을 식별하는 시즌 번호 또는 에피소드 애셋과 연결된 시즌 번호입니다. 이 필드의 최대 길이는 5바이트입니다.

episodeNumber

string

에피소드 애셋과 연결된 에피소드 번호입니다. 이 필드는 프로그램 애셋에 연결된 에피소드 애셋에만 필요하며 해당 애셋에만 사용됩니다. 최대 길이는 5바이트입니다.

writer[]

string

저작물과 연결된 작가를 식별하는 목록입니다. 저작물에 최대 50명의 작성자를 지정할 수 있습니다.

actor[]

string

저작물과 연결된 배우를 식별하는 목록입니다. 저작물에 최대 50명의 배우를 지정할 수 있습니다.

director[]

string

저작물과 연결된 감독을 식별하는 목록입니다. 저작물에 최대 50명의 감독을 지정할 수 있습니다.

producer[]

string

애셋의 제작자를 식별하는 목록입니다. 저작물에 최대 50명의 제작자를 지정할 수 있습니다.

releaseDate

object (Date)

저작물이 공개적으로 출시된 날짜입니다. 시즌 저작물의 경우 이 값은 시즌이 처음 방송된 날짜를 지정합니다. 1902년 이전 날짜는 지원되지 않습니다. 이 값은 에피소드, 시즌, 영화, 뮤직비디오, 음원 저작물에 유효합니다. 아래에 나열된 저작물에는 필수이며 그 외에는 선택사항입니다.

  • 프로그램에 연결된 에피소드 애셋
  • YouTube의 영화 카테고리에 표시되는 영화 애셋
spokenLanguage

string

동영상에 나오는 기본 언어입니다. 값은 두 자리 ISO 639-1 언어 코드일 수 있습니다. 이 값은 에피소드 및 영화 저작물에만 사용되며 다른 유형의 저작물에는 유효하지 않습니다.

subtitledLanguage[]

string

동영상에 별도의 자막 트랙이 있거나 동영상의 일부로 삽입된 자체 자막이 있는 경우 언어 목록입니다. 목록의 각 값은 ISO 639-1 두 자리 언어 코드여야 합니다. 이 값은 에피소드 및 영화 저작물에만 사용되며 다른 유형의 저작물에는 유효하지 않습니다.

isan

string

저작물의 ISAN (International Standard Audiovisual Number)입니다. 이 값은 에피소드 및 영화 저작물에만 사용되며 두 경우 모두 선택사항입니다. 값은 26자리이며, 다음과 같은 형식으로 ISAN의 24자리 16진수 문자 및 2자리 확인 문자가 포함됩니다.

  • 태그 값의 처음 16자에는 ISAN의 '루트' 및 '에피소드' 구성요소를 지정하는 16진수 문자가 포함됩니다.
  • 17번째 문자는 확인 문자 (A~Z의 문자)입니다.
  • 18~25번째 문자는 ISAN의 나머지 8자리 문자이며 ISAN의 '버전' 구성요소를 지정합니다.
  • 26번째 문자는 다른 확인 문자(A~Z)입니다.
eidr

string

저작물에 할당된 EIDR (Entertainment Identifier Registry)입니다. 이 값은 에피소드 및 영화 저작물에만 사용되며 두 경우 모두 선택사항입니다. 값에는 EIDR 등록을 위한 표준 프리픽스가 포함되며, 그 뒤로 슬래시, 20자리 16진수 문자열 및 영숫자(0~9/A~Z)인 1자리 확인 문자가 이어집니다.

hfa

string

음악작품을 고유하게 식별하기 위해 발급된 6자리 HFA (Harry Fox Agency) 노래 코드입니다. 이 값은 음악작품 저작물에만 유효합니다.

ratings[]

object (Rating)

애셋이 받은 등급 목록입니다. 등급은 지정된 등급 분류에 따라 유효해야 합니다.

broadcaster[]

string

프로그램이나 프로그램의 시즌을 최초로 방송한 네트워크 또는 채널을 식별합니다. 이 필드는 애셋과 연결된 방송국이 YouTube에 애셋을 업로드하는 파트너와 다른 경우에만 애셋에 포함해야 합니다. 프로그램에는 여러 방송사가 있을 수 있습니다. 예를 들어 시즌 간에 네트워크가 전환될 수 있습니다.

totalEpisodesExpected

integer (uint32 format)

시즌에 있는 전체 길이 에피소드의 총 개수를 지정합니다. 이 값은 시즌 애셋에만 사용됩니다.

contentType

string

저작물이 나타내는 동영상 콘텐츠의 유형입니다. 이 필드는 영화 및 에피소드 저작물에만 유효하며, 다음 유형의 저작물에 필요합니다.

  • 프로그램에 연결된 에피소드 애셋
  • YouTube의 영화 카테고리에 표시되는 영화 애셋

사용 가능한 값:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

동영상 애셋이 시청자에게 처음으로 제공되었던 방식입니다. 이 값은 에피소드 및 영화 저작물에만 사용됩니다. 다음 애셋에는 필수이며 그 외에는 선택사항입니다.

  • 프로그램에 연결된 에피소드 애셋
  • YouTube의 영화 카테고리에 표시되는 영화 애셋

사용 가능한 값:

  • basic_tv
  • direct_to_video
  • film
  • premium_tv
  • promotional
  • terrestrial_tv
  • web

날짜

이 리소스는 구성요소 (연도, 월, 일)로 표시되는 날짜를 식별합니다.

JSON 표현
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer (uint32 format)

그레고리력의 날짜 연도입니다. 서기(A.D.)로 간주됩니다.

month

integer (uint32 format)

날짜의 월입니다. 값은 1에서 12 사이의 정수여야 합니다.

day

integer (uint32 format)

날짜의 일입니다. 값은 1에서 31 사이의 정수여야 합니다. 일부 일-월 조합은 유효하지 않습니다.

등급

이 객체에는 애셋의 콘텐츠 등급이 포함되어 있습니다.

JSON 표현
{
  "ratingSystem": string,
  "rating": string
}
필드
ratingSystem

string

등급과 연결된 등급 시스템입니다.

사용 가능한 값:

  • acb
  • age_gate_16
  • bbfc
  • cbfc
  • chvrs
  • djctq
  • eirin
  • esrb
  • fmoc
  • fsk
  • icaa
  • kmrb
  • lyrics
  • mpaa
  • oflc
  • russia
  • v_chip
  • youtube
  • youtubeuk
rating

string

애셋이 받은 평가입니다.