TV 프로그램의 콘텐츠 마크업 속성

이 섹션에서는 TVSeries, TVEpisode, TVSeason 항목 유형의 콘텐츠 마크업 속성에 관한 세부정보를 제공합니다.

TVSeason를 전체 항목으로 제공하는 것은 선택사항입니다. 자세한 내용은 TVSeries, TVSeason, TVEpisode 관계 섹션을 참고하세요.

사양 표

TVSeries

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
로 설정
  • 여기서 'xx'는 피드의 문자열 언어를 나타냅니다. 각 루트 항목 컨텍스트의 @language는 BCP 47 형식의 적절한 언어 코드로 설정되어야 합니다. 예를 들어 언어가 스페인어로 설정된 경우 자막/더빙 언어가 영어로 되어 있더라도 이름은 스페인어로 간주됩니다.
@type 텍스트 필수 - 항상 TVSeries로 설정합니다.
@id URL 필수 - 콘텐츠의 식별자(URI 형식)입니다(예: https://example.com/1234abc).
@id는 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전반에서 고유함
  • ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다 (프로그램의 URL 속성이 변경되더라도). 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유해야 합니다.
항목의 url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url을 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
url URL 필수 - Google에서 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시키는 데 사용하는 콘텐츠의 표준 URL입니다.
url은 다음 요구사항을 충족해야 합니다.
  • url은 전역적으로 고유해야 합니다.
  • url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
재생의 딥 링크의 경우 타겟 객체의 urlTemplate 속성을 참고하세요.
name 텍스트 필수 - 프로그램 이름입니다.
  • 배열을 사용하여 여러 언어로 이름을 나열합니다. 여러 리전 및 언어 예시를 참고하세요.
  • 언어 (언어-국가 쌍)당 하나의 이름만 지원됩니다.
titleEIDR 텍스트 적극 권장됨 이유 - 영화 또는 TV 저작물을 가장 일반적이고 추상적인 수준에서 나타내는 EIDR (Entertainment Identifier Registry) 식별자입니다.

예를 들어 '왕좌의 게임'이라는 TV 시리즈의 titleEIDR은 '10.5240/C1B5-3BA1-8991-A571-8472-W'입니다.
potentialAction WatchAction 해당하는 경우 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다.
  • 콘텐츠를 VOD (주문형 동영상)에서 사용할 수 있는 경우 이 속성이 필요합니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • 콘텐츠를 LiveTV 채널에서 사용할 수 있는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 대신 채널의 딥 링크를 제공합니다.
  • TVSeries는 VoD와 LiveTV에서 모두 사용할 수 있습니다.
배열을 사용하여 여러 리전에서 서로 다른 딥 링크를 지정합니다. 여러 리전 및 언어 예시를 참고하세요.
sameAs URL 적극 권장됨 이유 프로그램의 정체를 파악할 수 있는 참조 웹페이지의 URL입니다(예: 프로그램의 Wikipedia 페이지). url 속성과는 구별되어야 합니다.
inLanguage 텍스트 BCP 47 형식의 시리즈 원본 언어입니다.
genre 텍스트 모든 관련 장르의 순서가 지정된 목록입니다. 예 : ["Action", "Fashion", "Environment", "Football"]
keywords 텍스트 이 콘텐츠를 설명하는 데 사용된 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ["feature, biography"] 는 콘텐츠를 설명하는 키워드 배열일 수 있습니다.
releasedEvent PublicationEvent, FeaturedEvent 또는 ExclusiveEvent 적극 권장됨 이유 - PublicationEvent는 영화의 원래 극장 개봉일과 같이 게시자가 콘텐츠의 원래 (전 세계 또는 지역) 발표를 지정하는 데 사용됩니다.

또한 FeaturedEvent를 사용하여 서비스에서 이 콘텐츠를 오리지널, 추천, 스페셜 등으로 마케팅하고 있음을 나타낼 수 있습니다.

ExclusiveEvent는 서비스에 배타적인 배급 권리가 있음을 지정하고 배급 지역과 시기를 포함합니다.

자세한 내용과 예시는 예시 섹션을 참고하세요.
releasedEvent.@type 텍스트 필수 - 이 속성은 항상 다음 중 하나로 설정해야 합니다.
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 국가 필수 - 이 이벤트와 연결된 지역입니다.

PublicationEvent의 경우 콘텐츠가 게시된 지역입니다.

FeaturedEvent 및 ExclusiveEvent의 경우 콘텐츠가 추천되거나 독점적으로 제공되는 지역입니다.

국가의 경우 ISO 3166 코드를 사용하세요. 전 세계 모든 위치를 나타내려면 EARTH로 설정합니다.
releasedEvent.startDate Date 또는 DateTime 권장 - ExclusiveEvent의 경우 필수 - 항목 게시 시작일입니다.

PublicationEvent의 경우 영화가 극장에서 처음 개봉된 날짜와 같이 이 항목의 최초 출시일을 나타냅니다.

ExclusiveEvent 및 FeaturedEvent의 경우 항목이 독점 또는 추천된 시작일을 나타냅니다.
releasedEvent.endDate Date 또는 DateTime 권장 - ExclusiveEvent의 경우 필수 - ExclusiveEvent 및 FeaturedEvent 유형에만 적용됩니다.

ExclusiveEvent의 경우 콘텐츠 권리가 만료되는 날짜를 나타냅니다.

FeaturedEvent의 경우 제공업체가 항목을 추천한 마지막 날짜를 나타냅니다.

콘텐츠가 영구적으로 독점 또는 추천되는 경우 endDate를 현재 날짜로부터 20년으로 설정합니다.
releasedEvent.publishedBy Organization 또는 Person 선택사항 - 이 항목을 게시한 조직 또는 사람입니다.
description 텍스트 적극 권장됨 이유 프로그램의 개요입니다. 사실 요약보다 줄거리 개요가 선호됩니다. 300자(영문 기준)로 제한됩니다.
  • 배열을 사용하여 여러 언어로 설명을 마크업합니다. 여러 리전 및 언어 예시를 참고하세요.
actor Person 또는 PerformingGroup 또는 PerformanceRole 적극 권장됨 이유 시리즈의 출연자 배열입니다. 여기에서 모델링 안내를 참고하세요.
director 사람 적극 권장됨 이유 프로그램의 감독입니다.
producer Organization 또는 Person 적극 권장됨 이유 프로그램의 제작자입니다.
image ImageObject Google TV에 필요 - TV 시리즈와 관련된 이미지입니다. image에 포함할 필수 및 선택 속성에 관한 자세한 내용은 이미지 속성을 참고하세요.
trailer.description 텍스트 트레일러에 대한 설명입니다. 트레일러 예를 참고하세요.
trailer.inLanguage 텍스트 트레일러의 언어입니다(BCP 47 형식).
trailer.url URL 각 제작 스튜디오 또는 승인된 소스에서 공개적으로 호스팅하고 업로드한 트레일러의 URL입니다.
trailer.regionsAllowed 장소 미디어가 허용되는 지역입니다. 지정하지 않으면 모든 지역에서 허용되는 것으로 간주됩니다. ISO 3166 형식으로 국가를 지정합니다.
identifier PropertyValue 적극 권장됨 이유 - 이 항목을 명확하게 식별하는 외부 또는 기타 ID입니다. 여러 식별자가 허용됩니다. 자세한 내용은 식별자 속성 섹션을 참고하세요.
popularityScore PopularityScoreSpecification 적극 권장됨 이유 Google에서 사용자에게 재생할 미디어를 결정하기 위해 사용하는 점수와 기타 신호입니다. 이 점수는 카탈로그의 다른 콘텐츠와 비교한 콘텐츠의 인기도를 나타냅니다. 따라서 점수의 크기는 카탈로그의 모든 항목 간에 피드에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다.
popularityScore.@type 텍스트 항상 PopularityScoreSpecification로 설정합니다.
popularityScore.value 숫자 항목의 인기도를 나타내는 비음수 숫자 값입니다. 점수가 높을수록 인기도가 높습니다.
popularityScore.eligibleRegion 국가 이 인기 점수가 적용되는 지역입니다. 인기 점수가 전 세계적으로 적용되는 경우 EARTH로 설정합니다. 기본적으로 이 속성은 EARTH로 설정됩니다.
Note: 언어별 인기도가 전 세계 (EARTH) 인기도보다 우선 적용됩니다.
review 리뷰 TV 시리즈 평점 검토
review.reviewRating 평점 review가 제공된 경우 필수 리뷰에 주어진 평점을 지정하는 데 사용됩니다.
contentRating Text 또는 Rating 성인용 콘텐츠의 경우 필수사항이며 그 외의 경우 권장사항 - 전체 콘텐츠 등급 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 다음 두 가지 변형이 허용됩니다.
  • 평가 기관에서 평점에 공백을 넣고 접두어를 추가했습니다. 예를 들어 미국의 'TVPG' 기관에서 부여한 'TV-MA' 등급은 'TVPG TV-MA'로 표시해야 합니다. 기관 목록을 참고하세요.
  • 'RATING NOT KNOWN' 값(대소문자 구분 안 함)은 콘텐츠의 등급을 알 수 없음을 나타냅니다.
contentRating.author 조직 contentRating에서 Rating를 사용하는 경우 필요 - 신용 평가 기관의 이름입니다. 허용되는 등급 부여 기관 목록은 콘텐츠 등급 부여 기관 페이지를 참고하세요.
contentRating.ratingValue 텍스트 contentRating가 Rating를 사용하는 경우 필요 - 평점 값입니다.
contentRating.advisoryCode 텍스트 콘텐츠의 고지 코드입니다. 허용되는 값은 D, FV, L, S, V입니다. D = 대화, FV = 판타지 폭력 , L = 언어, S = 성적인 콘텐츠, V = 폭력

TVEpisode

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
로 설정
  • 여기서 'xx'는 피드의 문자열 언어를 나타냅니다. 각 루트 항목 컨텍스트의 @language는 BCP 47 형식의 적절한 언어 코드로 설정되어야 합니다. 예를 들어 언어가 스페인어로 설정된 경우 자막/더빙 언어가 영어로 되어 있더라도 이름은 스페인어로 간주됩니다.
@type 텍스트 필수 - 항상 TVEpisode로 설정합니다.
@id URL 필수 - 콘텐츠의 식별자(URI 형식)입니다(예: https://example.com/1234abc).
@id는 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전반에서 고유함
  • ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다 (프로그램의 URL 속성이 변경되더라도). 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유해야 합니다.
항목의 url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url을 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
url URL 필수 - Google에서 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시키는 데 사용하는 콘텐츠의 표준 URL입니다.
url은 다음 요구사항을 충족해야 합니다.
  • url은 전역적으로 고유해야 합니다.
  • url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
재생의 딥 링크의 경우 타겟 객체의 urlTemplate 속성을 참고하세요.
name 텍스트 필수 - 에피소드의 이름입니다.
  • 배열을 사용하여 여러 언어로 이름을 나열합니다. 다중 언어 표현 예를 참고하세요.
  • 언어 (언어-국가 쌍)당 하나의 이름만 지원됩니다.
titleEIDR 텍스트 적극 권장됨 이유 - 영화 또는 TV 저작물을 가장 일반적이고 추상적인 수준에서 나타내는 EIDR (Entertainment Identifier Registry) 식별자입니다.

예를 들어 '왕좌의 게임'이라는 TV 시리즈의 첫 번째 시즌 첫 번째 에피소드의 titleEIDR은 '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X'입니다.
editEIDR 텍스트 적극 권장됨 이유 - 영화 또는 TV 저작물의 특정 수정 / 버전을 나타내는 EIDR (Entertainment Identifier Registry) 식별자입니다.

예를 들어 'Game of Thrones'라는 TV 시리즈의 첫 번째 시즌 첫 번째 에피소드의 제목 EIDR은 '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X'이고 수정본은 1개(예: '10.5240/FB97-C847-2969-D0AB-ECD1-C')입니다. editEIDR가 제공된 경우

titleEIDR 속성이 필수입니다.
inLanguage 텍스트 BCP 47 형식의 시리즈 원본 언어입니다.
episodeNumber 정수 필수 - 시즌의 에피소드 순서에서 이 에피소드의 위치를 나타내는 숫자입니다. episodeNumber는 시즌마다 다시 시작해야 합니다. 즉, 각 시즌의 첫 번째 에피소드는 1이어야 합니다.
partOfSeason TVSeason 필수 - 이 에피소드가 속한 TV 시즌입니다.

TVEpisode에 상응하는 TVSeason가 없더라도 partOfSeason.@id 및 partOfSeason.seasonNumber 속성을 제공해야 합니다. 해결 방법은 다음과 같습니다.
  • partofSeries.@id (예: http://www.example.com/my_favorite_tv_show)를 가져와 자리표시자 쿼리 필드 (예: ?season1)를 연결하여 고유한 partOfSeason.@id (예: http://www.example.com/my_favorite_tv_show?season1)를 만듭니다.
  • partOfSeason.seasonNumber를 1로 설정합니다.
partOfSeason.@type 텍스트 필수 - 항상 TVSeason로 설정합니다.
partOfSeason.@id URL 필수 - 이 에피소드가 속한 TVSeason의 @id입니다.
partOfSeason.seasonNumber 정수 필수 - TV 시리즈의 시즌 순서에서 이 시즌의 위치를 나타내는 숫자입니다.
partOfSeries TVSeries 필수 - 이 에피소드가 속한 TV 시리즈입니다.
partOfSeries.@type 텍스트 필수 - 항상 TVSeries로 설정합니다.
partOfSeries.@id URL 필수 - 이 에피소드가 속한 TVSeries의 @id입니다.
partOfSeries.name 텍스트 필수 - TV 시리즈의 이름입니다.
partOfSeries.sameAs 텍스트 프로그램의 정체를 파악할 수 있는 참조 웹페이지의 URL입니다(예: 프로그램의 Wikipedia 페이지). url 속성과는 구별되어야 합니다.
potentialAction WatchAction 해당하는 경우 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다.
  • 콘텐츠를 VOD (주문형 동영상)에서 사용할 수 있는 경우 이 속성이 필요합니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • 콘텐츠를 LiveTV 채널에서 사용할 수 있는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 대신 채널의 딥 링크를 제공합니다.
  • TVEpisode는 VoD와 LiveTV에서 모두 사용할 수 있습니다.
배열을 사용하여 여러 리전에서 서로 다른 딥 링크를 지정합니다. 여러 리전 및 언어 예시를 참고하세요.
sameAs 적극 권장됨 이유 URL 에피소드를 식별할 수 있는 참조 웹페이지의 URL입니다(예: 에피소드의 위키피디아 페이지). 이 값은 url 속성과 구분되어야 합니다.
duration 기간 에피소드의 런타임이며 ISO 8601 형식으로 나타냅니다. 'PT00H00M' 형식을 사용하세요.
releasedEvent PublicationEvent, FeaturedEvent 또는 ExclusiveEvent 적극 권장됨 이유 - PublicationEvent는 영화의 원래 극장 개봉일과 같이 게시자가 콘텐츠의 원본 (전 세계 또는 지역) 출시를 지정하는 데 사용됩니다.

또한 FeaturedEvent를 사용하여 서비스에서 이 콘텐츠를 오리지널, 추천, 스페셜 등으로 마케팅하고 있음을 나타낼 수 있습니다.

ExclusiveEvent는 서비스에 배타적인 배급 권리가 있음을 지정하고 배급 지역과 시기를 포함합니다.

자세한 내용과 예시는 예시 섹션을 참고하세요.
releasedEvent.@type 텍스트 필수 - 이 속성은 항상 다음 중 하나로 설정해야 합니다.
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 국가 필수 - 이 이벤트와 연결된 지역입니다.

PublicationEvent의 경우 콘텐츠가 게시된 지역입니다.

FeaturedEvent 및 ExclusiveEvent의 경우 콘텐츠가 추천되거나 독점적으로 제공되는 지역입니다.

국가의 경우 ISO 3166 코드를 사용하세요. 전 세계 모든 위치를 나타내려면 EARTH로 설정합니다.
releasedEvent.startDate Date 또는 DateTime 권장 - ExclusiveEvent의 경우 필수 - 항목 게시 시작일입니다.

PublicationEvent의 경우 영화가 극장에서 처음 개봉된 날짜와 같이 이 항목의 최초 출시일을 나타냅니다.

ExclusiveEvent 및 FeaturedEvent의 경우 항목이 독점 또는 추천된 시작일을 나타냅니다.
releasedEvent.endDate Date 또는 DateTime 권장 - ExclusiveEvent의 경우 필수 - ExclusiveEvent 및 FeaturedEvent 유형에만 적용됩니다.

ExclusiveEvent의 경우 콘텐츠 권리가 만료되는 날짜를 나타냅니다.

FeaturedEvent의 경우 제공업체가 항목을 추천한 마지막 날짜를 나타냅니다.

콘텐츠가 영구적으로 독점 또는 추천되는 경우 endDate를 현재 날짜로부터 20년으로 설정합니다.
releasedEvent.publishedBy Organization 또는 Person 선택사항 - 이 항목을 게시한 조직 또는 사람입니다.
description 텍스트 적극 권장됨 이유 에피소드의 개요입니다. 사실 요약보다 줄거리 개요가 선호됩니다. 300자(영문 기준)로 제한됩니다.
  • 배열을 사용하여 여러 언어로 설명을 마크업합니다. 다중 언어 표현 예를 참고하세요.
genre 텍스트 모든 관련 장르의 순서가 지정된 목록입니다. 예 : ["Action", "Fashion", "Environment", "Football"]
keywords 텍스트 이 콘텐츠를 설명하는 데 사용된 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ["feature, biography"] 는 콘텐츠를 설명하는 키워드 배열일 수 있습니다.
actor Person 또는 PerformingGroup 또는 PerformanceRole 적극 권장됨 이유 에피소드의 출연자 배열입니다. 여기에서 모델링 안내를 참고하세요.
director 사람 적극 권장됨 이유 에피소드의 감독입니다.
producer Organization 또는 Person 적극 권장됨 이유 시즌의 제작자입니다.
image ImageObject Google TV용 권장사항: TVEpisode와 관련된 다양한 이미지 image에 포함할 필수 및 선택 속성에 관한 자세한 내용은 이미지 속성을 참고하세요.
trailer.description 텍스트 트레일러에 대한 설명입니다. 트레일러 예를 참고하세요.
trailer.inLanguage 텍스트 트레일러의 언어입니다(BCP 47 형식).
trailer.url URL 각 제작 스튜디오 또는 승인된 소스에서 공개적으로 호스팅하고 업로드한 트레일러의 URL입니다.
trailer.regionsAllowed 장소 미디어가 허용되는 지역입니다. 지정하지 않으면 모든 지역에서 허용되는 것으로 간주됩니다. ISO 3166 형식으로 국가를 지정합니다.
review 리뷰 TV 에피소드 평점 검토
review.reviewRating 평점 review가 제공된 경우 필수 리뷰에 주어진 평점을 지정하는 데 사용됩니다.
contentRating Text 또는 Rating 성인용 콘텐츠의 경우 필수사항이며 그 외의 경우 권장사항 - 전체 콘텐츠 등급 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 다음 두 가지 변형이 허용됩니다.
  • 평가 기관에서 평점에 공백을 넣고 접두어를 추가했습니다. 예를 들어 미국의 'TVPG' 기관에서 부여한 'TV-MA' 등급은 'TVPG TV-MA'로 표시해야 합니다. 기관 목록을 참고하세요.
  • 'RATING NOT KNOWN' 값(대소문자 구분 안 함)은 콘텐츠의 등급을 알 수 없음을 나타냅니다.
contentRating.author 조직 contentRating이 Rating를 사용하는 경우 필요 - 신용 평가 기관의 이름입니다. 허용되는 등급 부여 기관 목록은 콘텐츠 등급 부여 기관 페이지를 참고하세요.
contentRating.ratingValue 텍스트 contentRating가 Rating를 사용하는 경우 필요 - 평점 값입니다.
contentRating.advisoryCode 텍스트 콘텐츠의 고지 코드입니다. 허용되는 값은 D, FV, L, S, V입니다. D = 대화, FV = 판타지 폭력 , L = 언어, S = 성적인 콘텐츠, V = 폭력
identifier PropertyValue 적극 권장됨 이유 - 이 항목을 명확하게 식별하는 외부 또는 기타 ID입니다. 여러 식별자가 허용됩니다. 자세한 내용은 식별자 속성 섹션을 참고하세요.
popularityScore PopularityScoreSpecification 적극 권장됨 이유 Google에서 사용자에게 재생할 미디어를 결정하기 위해 사용하는 점수와 기타 신호입니다. 이 점수는 카탈로그의 다른 콘텐츠와 비교한 콘텐츠의 인기도를 나타냅니다. 따라서 점수의 크기는 카탈로그의 모든 항목 간에 피드에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다.
popularityScore.@type 텍스트 항상 PopularityScoreSpecification로 설정합니다.
popularityScore.value 숫자 항목의 인기도를 나타내는 비음수 숫자 값입니다. 점수가 높을수록 인기도가 높습니다.
popularityScore.eligibleRegion 국가 이 인기 점수가 적용되는 지역입니다. 인기 점수가 전 세계적으로 적용되는 경우 EARTH로 설정합니다. 기본적으로 이 속성은 EARTH로 설정됩니다.
Note: 언어별 인기도가 전 세계 (EARTH) 인기도보다 우선 적용됩니다.

TVSeason

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
로 설정
  • 여기서 'xx'는 피드의 문자열 언어를 나타냅니다. 각 루트 항목 컨텍스트의 @language는 BCP 47 형식의 적절한 언어 코드로 설정되어야 합니다. 예를 들어 언어가 스페인어로 설정된 경우 자막/더빙 언어가 영어로 되어 있더라도 이름은 스페인어로 간주됩니다.
@type 텍스트 필수 - 항상 TVSeason로 설정합니다.
@id URL 필수 - 콘텐츠의 식별자(URI 형식)입니다(예: https://example.com/1234abc).
@id는 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전반에서 고유함
  • ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다 (프로그램의 URL 속성이 변경되더라도). 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유해야 합니다.
항목의 url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url을 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
url URL 필수 - Google에서 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시키는 데 사용하는 콘텐츠의 표준 URL입니다.
url은 다음 요구사항을 충족해야 합니다.
  • url은 전역적으로 고유해야 합니다.
  • url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
재생의 딥 링크의 경우 타겟 객체의 urlTemplate 속성을 참고하세요.
name 텍스트 필수 - 이 TV 시즌의 이름입니다.
  • 배열을 사용하여 여러 언어로 이름을 나열합니다. 다중 언어 표현 예를 참고하세요.
  • 언어 (언어-국가 쌍)당 하나의 이름만 지원됩니다.
titleEIDR 텍스트 적극 권장됨 이유 - 영화 또는 TV 저작물을 가장 일반적이고 추상적인 수준에서 나타내는 EIDR (Entertainment Identifier Registry) 식별자입니다.

예를 들어 '왕좌의 게임'이라는 TV 시리즈의 첫 번째 시즌의 titleEIDR은 '10.5240/FD91-C72C-4161-FCBA-058B-1'입니다.
seasonNumber 정수 필수 - TV 시리즈의 시즌 순서에서 이 시즌의 위치를 나타내는 숫자입니다.
partOfSeries TVSeries 필수 - 이 시즌이 속한 TV 시리즈입니다.
partOfSeries.@type 텍스트 필수 - 항상 TVSeries로 설정합니다.
partOfSeries.@id URL 필수 - 이 시즌이 속한 TVSeries의 @id입니다.
partOfSeries.name 텍스트 필수 - TV 시리즈의 이름입니다.
partOfSeries.sameAs 텍스트 프로그램의 정체를 파악할 수 있는 참조 웹페이지의 URL입니다(예: 프로그램의 Wikipedia 페이지). 이 값은 url 속성과 구분되어야 합니다.
potentialAction WatchAction 해당하는 경우 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다.
  • 콘텐츠를 VOD (주문형 동영상)에서 사용할 수 있는 경우 이 속성이 필요합니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • 콘텐츠를 LiveTV 채널에서 사용할 수 있는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 대신 채널의 딥 링크를 제공합니다.
  • TVSeason는 VoD와 LiveTV에서 모두 사용할 수 있습니다.
배열을 사용하여 여러 리전에서 서로 다른 딥 링크를 지정합니다. 여러 리전 및 언어 예시를 참고하세요.
sameAs URL 적극 권장됨 이유 시즌을 식별할 수 있는 참조 웹페이지의 URL입니다(예: 시즌의 Wikipedia 페이지). url 속성과는 구별되어야 합니다.
releasedEvent PublicationEvent, FeaturedEvent 또는 ExclusiveEvent 적극 권장됨 이유 - PublicationEvent는 영화의 원래 극장 개봉일과 같이 게시자가 콘텐츠의 원본 (전 세계 또는 지역) 출시를 지정하는 데 사용됩니다.

또한 FeaturedEvent를 사용하여 서비스에서 이 콘텐츠를 오리지널, 추천, 스페셜 등으로 마케팅하고 있음을 나타낼 수 있습니다.

ExclusiveEvent는 서비스에 배타적인 배급 권리가 있음을 지정하고 배급 지역과 시기를 포함합니다.

자세한 내용과 예시는 예시 섹션을 참고하세요.
releasedEvent.@type 텍스트 필수 - 이 속성은 항상 다음 중 하나로 설정해야 합니다.
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 국가 필수 - 이 이벤트와 연결된 지역입니다.

PublicationEvent의 경우 콘텐츠가 게시된 지역입니다.

FeaturedEvent 및 ExclusiveEvent의 경우 콘텐츠가 추천되거나 독점적으로 제공되는 지역입니다.

국가의 경우 ISO 3166 코드를 사용하세요. 전 세계 모든 위치를 나타내려면 EARTH로 설정합니다.
releasedEvent.startDate Date 또는 DateTime 권장 - ExclusiveEvent의 경우 필수 - 항목 게시 시작일입니다.

PublicationEvent의 경우 영화가 극장에서 처음 개봉된 날짜와 같이 이 항목의 최초 출시일을 나타냅니다.

ExclusiveEvent 및 FeaturedEvent의 경우 항목이 독점 또는 추천된 시작일을 나타냅니다.
releasedEvent.endDate Date 또는 DateTime 권장 - ExclusiveEvent의 경우 필수 - ExclusiveEvent 및 FeaturedEvent 유형에만 적용됩니다.

ExclusiveEvent의 경우 콘텐츠 권리가 만료되는 날짜를 나타냅니다.

FeaturedEvent의 경우 제공업체가 항목을 추천한 마지막 날짜를 나타냅니다.

콘텐츠가 영구적으로 독점 또는 추천되는 경우 endDate를 현재 날짜로부터 20년으로 설정합니다.
releasedEvent.publishedBy Organization 또는 Person 선택사항 - 이 항목을 게시한 조직 또는 사람입니다.
description 텍스트 적극 권장됨 이유 시즌의 개요입니다. 사실 요약보다 줄거리 개요가 선호됩니다. 300자(영문 기준)로 제한됩니다.
  • 배열을 사용하여 여러 언어로 설명을 마크업합니다. 다중 언어 표현 예를 참고하세요.
actor [Person 또는 PerformingGroup 또는 PerformanceRole 적극 권장됨 이유 시즌의 출연자 배열입니다. 여기에서 모델링 안내를 참고하세요.
director 사람 적극 권장됨 이유 프로그램의 감독 배열입니다.
producer Organization 또는 Person 적극 권장됨 이유 시즌의 제작자입니다.
image ImageObject TV 시즌과 관련된 이미지입니다. image에 포함할 필수 및 선택 속성에 관한 자세한 내용은 이미지 속성을 참고하세요.
genre 텍스트 모든 관련 장르의 순서가 지정된 목록입니다. 예 : ["Action", "Fashion", "Environment", "Football"]
keywords 텍스트 이 콘텐츠를 설명하는 데 사용된 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ["feature, biography"] 는 콘텐츠를 설명하는 키워드 배열일 수 있습니다.
trailer.description 텍스트 트레일러에 대한 설명입니다. 트레일러 예시를 참고하세요.
trailer.inLanguage 텍스트 트레일러의 언어입니다(BCP 47 형식).
trailer.url URL 각 제작 스튜디오 또는 승인된 소스에서 공개적으로 호스팅하고 업로드한 트레일러의 URL입니다.
trailer.regionsAllowed 장소 미디어가 허용되는 지역입니다. 지정하지 않으면 모든 지역에서 허용되는 것으로 간주됩니다. ISO 3166 형식으로 국가를 지정합니다.
identifier PropertyValue 적극 권장됨 이유 - 이 항목을 명확하게 식별하는 외부 또는 기타 ID입니다. 여러 식별자가 허용됩니다. 자세한 내용은 식별자 속성 섹션을 참고하세요.
popularityScore PopularityScoreSpecification 적극 권장됨 이유 Google에서 사용자에게 재생할 미디어를 결정하기 위해 사용하는 점수와 기타 신호입니다. 이 점수는 카탈로그의 다른 콘텐츠와 비교한 콘텐츠의 인기도를 나타냅니다. 따라서 점수의 크기는 카탈로그의 모든 항목 간에 피드에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다.
popularityScore.@type 텍스트 항상 PopularityScoreSpecification로 설정합니다.
popularityScore.value 숫자 항목의 인기도를 나타내는 비음수 숫자 값입니다. 점수가 높을수록 인기도가 높습니다.
popularityScore.eligibleRegion 국가 이 인기 점수가 적용되는 지역입니다. 인기 점수가 전 세계적으로 적용되는 경우 EARTH로 설정합니다. 기본적으로 이 속성은 EARTH로 설정됩니다.
Note: 언어별 인기도가 전 세계 (EARTH) 인기도보다 우선 적용됩니다.
review 리뷰 TV 시즌 평점 검토
review.reviewRating 평점 review가 제공된 경우 필수 리뷰에 주어진 평점을 지정하는 데 사용됩니다.
contentRating Text 또는 Rating 성인용 콘텐츠의 경우 필수사항이며 그 외의 경우 권장사항 - 전체 콘텐츠 등급 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 다음 두 가지 변형이 허용됩니다.
  • 평가 기관에서 평점에 공백을 넣고 접두어를 추가했습니다. 예를 들어 미국의 'TVPG' 기관에서 부여한 'TV-MA' 등급은 'TVPG TV-MA'로 표시해야 합니다. 기관 목록을 참고하세요.
  • 'RATING NOT KNOWN' 값(대소문자 구분 안 함)은 콘텐츠의 등급을 알 수 없음을 나타냅니다.
contentRating.author 조직 contentRating에서 Rating를 사용하는 경우 필요 - 신용 평가 기관의 이름입니다. 허용되는 등급 부여 기관 목록은 콘텐츠 등급 부여 기관 페이지를 참고하세요.
contentRating.ratingValue 텍스트 contentRating가 Rating를 사용하는 경우 필요 - 평점 값입니다.
contentRating.advisoryCode 텍스트 콘텐츠의 고지 코드입니다. 허용되는 값은 D, FV, L, S, V입니다. D = 대화, FV = 판타지 폭력 , L = 언어, S = 성적인 콘텐츠, V = 폭력입니다.

작업 수행자 사양

TVSeries, TVEpisode, TVSeason 항목 유형의 actor 속성을 사용하면 캐릭터 이름, TV 프로그램에서 맡은 역할 등 배우에 관한 세부정보를 지정할 수 있습니다. 다음 섹션에서는 사용법을 명확히 설명하는 몇 가지 예와 함께 동일한 내용을 설명합니다.

속성 예상 유형 설명
actor Person 또는 PerformingGroup 또는 PerformanceRole 적극 권장됨 이유 : 출연진의 배열입니다.
  • 연기한 역할과(선택사항) 출연진의 캐릭터 이름이 알려진 경우 PerformanceRole 유형을 사용합니다. 이 경우 행위자 Person 또는 PerformingGroup이 PerformanceRole 객체 내에 삽입됩니다.
  • 출연진이 맡은 역할이 알려지지 않은 경우 Person 유형을 사용하여 개별 배우를 나타내거나 PerformingGroup을 사용하여 공연 그룹/밴드의 세부정보를 제공합니다.

배열을 사용하여 여러 사람, PerformingGroup 또는 PerformanceRoles를 나타냅니다.

Person 또는 PerformingGroup 유형 사용

Person 또는 PerformingGroup 유형이 사용되는 경우 다음 속성을 제공합니다.

속성 예상 유형 설명
@type Person 또는 PerformingGroup 필수 - 항상 Person 또는 PerformingGroup으로 설정
@id URL 적극 권장됨 이유 - URI 형식의 배우 또는 공연 그룹 식별자(예: https://example.com/actor/abc) @id 는 다음 요구사항을 충족해야 합니다.
  • 카탈로그에서 배우/공연 그룹별로 전 세계적으로 고유함
  • ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다. 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유해야 합니다.

행위자 속성에 사용된 @id는 피드 전체에서 일관되게 사용해야 합니다. 예를 들어 동일한 배우가 등장하는 영화가 두 개 있는 경우 이 두 배우 객체에서 @id 값을 동일하게 유지해야 합니다.

name 텍스트 필수 - 배우/여배우/출연자/공연 그룹의 이름입니다.
sameAs URL 적극 권장됨 이유 - 배우 또는 공연 그룹을 식별할 수 있는 참조 웹페이지의 URL입니다(예: 배우의 Wikipedia 페이지). @id 속성과는 구별되어야 합니다.

PerformanceRole 유형 사용

PerformanceRole 유형이 사용되는 경우 다음 속성을 제공합니다.

속성 예상 유형 설명
@type PerformanceRole 필수 - 항상 PerformanceRole로 설정
roleName 텍스트 적극 권장됨 이유 - 출연자가 연기하거나 수행한 역할입니다. 허용되는 값 목록은 여기를 참고하세요.
characterName 텍스트 연기 또는 공연 역할에서 연기한 캐릭터의 이름입니다. 행위자 유형이 PerformingGroup인 경우 이 필드를 설정하지 마세요.
actor Person 또는 PerformingGroup 필수 -
  • 데이터 유형 인물이 사용되는 경우 콘텐츠의 출연자입니다.
  • 데이터 유형 PerformingGroup이 사용되는 경우 콘텐츠의 공연 그룹/밴드입니다.
actor.@type Person 또는 PerformingGroup 필수 - 항상 Person 또는 PerformingGroup으로 설정
actor.@id URL 적극 권장됨 이유 - URI 형식의 배우 또는 공연 그룹 식별자(예: https://example.com/actor/abc) @id는 다음 요구사항을 충족해야 합니다.
  • 카탈로그에서 배우/공연 그룹별로 전 세계적으로 고유함
  • ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다. 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유해야 합니다.

행위자 속성에 사용된 @id는 피드 전체에서 일관되게 사용해야 합니다. 예를 들어 동일한 배우가 등장하는 영화가 두 개 있는 경우 이 두 배우 객체에서 @id 값을 동일하게 유지해야 합니다.

actor.name 텍스트 필수 - 배우/여배우/출연자/공연 그룹의 이름입니다.
actor.sameAs URL 적극 권장됨 이유 - 배우 또는 공연 그룹을 식별할 수 있는 참조 웹페이지의 URL입니다(예: 배우의 Wikipedia 페이지). 이는 actor.@id 속성과 구별되어야 합니다.

허용되는 역할 이름

이러한 값을 사용하려면 actor.@type가 Person여야 합니다.

roleName 값 설명
'카메오' 카메오 역할(카메오 출연이라고도 함)은 공연 예술 작품에 유명인이 잠깐 등장하는 것입니다.
'VoiceActor' 음성 연기는 배우의 목소리가 사용되지만 배우가 화면에 등장하지 않는 연기입니다. 이는 애니메이션에서 가장 흔히 발견되지만, 한 배우의 목소리가 다른 배우의 말에 더빙될 때도 발생합니다.
'더블' 더블은 다른 배우를 대신하여 얼굴이 보이지 않도록 하는 사람입니다.
"MotionCaptureActor" MotionCaptureActor는 인간 배우의 동작을 기록하고 이 정보를 사용하여 2D 또는 3D 컴퓨터 애니메이션에서 디지털 캐릭터 모델을 애니메이션하는 사람을 나타냅니다.

이러한 값은 일반적으로 Person 및 PerformingGroup 유형에 허용됩니다.

roleName 값 설명
'행위자' 배우는 전통적인 연극 매체 또는 영화, 라디오, 텔레비전과 같은 현대 미디어에서 공연을 통해 캐릭터를 연기하는 사람입니다.
"GuestStar" "게스트 스타는 허구의 역할을 연기하고 하나 또는 몇 개의 에피소드에 출연하는 배우입니다. 게스트 스타가 주요 출연진에 속하지 않더라도 중요한 반복 캐릭터를 연기하고 시리즈에 여러 번 등장할 수도 있습니다. 출연자가 게스트로 출연했거나 프로그램에 게스트로 출연한 경우 값을 'GuestStar'로 설정합니다. 게스트 출연자는 에피소드 수준에서만 제공해야 하며 TVSeries 수준에서는 추가해서는 안 됩니다.
'게스트' "토크쇼 게스트. 'GuestStar'는 허구의 역할이지만 'Guest'는 허구가 아닌 출연입니다.
'아나운서' 아나운서는 프로그램의 시작과 끝을 알리는 인트로와 아우트로를 전달하고, 진행자, 참가자 또는 유명인 게스트를 소개하고, 제공되는 상품을 설명하고, 녹화 전에 시청자를 준비시키고 휴식 시간에 시청자의 흥미를 유도하는 사람입니다.
'해설자' 해설자는 일반적으로 라이브 방송 중에 경기나 이벤트에 대한 실시간 해설을 제공합니다.
"인상주의자" 인상주의자 또는 모방자는 유명인과 만화 캐릭터의 소리, 목소리, 매너를 모방하는 행위로 구성된 공연을 하는 연예인입니다.
'호스트' TV 프로그램을 소개, 진행 또는 주최하는 사람으로, 프로그램과 시청자 간의 중재자 역할을 하는 경우가 많습니다. '호스트'는 일반적으로 논픽션 역할입니다.
'공동 호스트' 다른 사람과 공동으로 이벤트/프로그램을 주최하는 사람입니다.
'GuestHost' 게스트 호스트는 일반적으로 토크쇼의 호스트로, 정규 호스트가 없을 때 대신 프로그램을 진행합니다.
'뉴스 캐스터' TV 뉴스 프로그램을 통해 지역, 국가, 국제적으로 발생하는 뉴스와 사건을 대중에게 알리는 사람입니다.
'특파원' 특파원 또는 현장 취재 기자는 보통 잡지의 언론인 또는 논평자이거나 신문, 라디오 또는 텔레비전 뉴스, 또는 다른 유형의 회사에 원격(종종 먼)한 위치에서 기사를 제공하는 대리인입니다.
'ShowJudge' 심사위원은 TV 프로그램의 분야에서 전문가로 간주되는 경우가 많으며, TV 프로그램의 오디션에 참여하고 경쟁에 참가하는 참가자를 비판하는 '심사위원' 역할을 맡습니다.
'패널 멤버' 라디오 또는 TV 패널의 토론 또는 자문 패널 멤버입니다.
'참가자' 경쟁 또는 게임 쇼의 참가자는 그 대회에 참여하는 사람입니다.
'StoryNarrator' 내레이터는 무언가를 설명하는 사람, 특히 소설이나 서사시의 사건을 설명하는 캐릭터를 의미합니다.
"MusicalArtist" '뮤직 아티스트는 일반적으로 정기적으로 관객 앞에서 공연하거나 음악 트랙이나 음악 앨범을 녹음한 사람, 그룹 또는 가상의 캐릭터일 수 있습니다. 작곡가와 작사가는 일부 음악 작품의 크레딧에서 주된 연주자로도 참여했음을 암시하는 경우에만 이 유형을 사용해야 합니다. 이 유형은 정규 아티스트 또는 아티스트 그룹, 게스트 아티스트 또는 아티스트 그룹을 프로그램에 연결하는 데 사용할 수 있습니다.

배우의 주연 및 조연 역할 구분

TV 프로그램에서 주연/정규 배우와 게스트/조연 배우를 구분하려면 TVSeries 항목에만 주연 배우를 추가하고 TVEpisode 항목에는 게스트 배우 또는 조연 역할이 있는 배우만 추가합니다. 기본/일반 출연진이 TVEpisode 항목에 추가되지 않았는지 확인합니다.

예

TVSeries, TVEpisode, TVSeason 예

TVSeries 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Actor 속성 예시

행위자의 역할이 알 수 없음

작업 수행자의 역할이 알려지지 않은 경우 Person 또는 PerformingGroup 유형을 사용하여 작업 수행자 정보를 제공하는 것이 좋습니다.

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

행위자의 역할이 알려짐

작업 수행자의 역할이 알려진 경우 PerformanceRole 유형을 사용하여 작업 수행자 정보를 제공하는 것이 좋습니다.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

행위자 하위 집합의 알려진 역할

연기 역할 메타데이터를 알 수 없는 경우 인물 또는 PerformingGroup 유형을 사용하여 배우 정보를 제공하는 것이 좋습니다. 이 정보가 알려진 다른 경우에는 PerformanceRole 유형을 사용합니다. 이러한 유형은 동일한 배열에 함께 추가할 수 있습니다.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

이러한 속성과 관련된 주제는 다음 페이지를 참고하세요.