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 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시켜야 합니다.
url은 다음 요구사항을 충족해야 합니다.
  • url는 전역적으로 고유해야 합니다.
  • url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
재생의 딥 링크target 객체의 urlTemplate 속성을 대신 참고하세요.
name 텍스트 필수 - 프로그램 이름입니다.
  • 배열을 사용하여 다양한 언어로 된 이름을 나열합니다. 여러 지역 및 언어 예를 참고하세요.
  • 언어당 하나의 이름만 지원됩니다 (언어-국가 쌍).
titleEIDR 텍스트 강력 추천 이유 - 가장 일반적인/추상적 수준에서 영화 또는 TV 작품을 나타내는 EIDR (Entertainment Identifier Registry) 식별자

예: '왕좌의 게임'으로 알려진 TV시리즈의 titleEIDR '10.5240/C1B5-3BA1-8991-A571-8472-W'입니다.
potentialAction WatchAction 해당하는 경우 필수 - 작업의 세부정보를 제공하는 Action 마크업 객체
  • VOD로 콘텐츠를 사용할 수 있는 경우 이 속성은 필수입니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • LiveTV 채널에서 콘텐츠를 사용할 수 있는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 채널의 딥 링크를 대신 제공합니다.
  • TVSeries는 VoD와 LiveTV에서 모두 사용할 수 있습니다.
배열을 사용하여 여러 지역에 서로 다른 딥 링크를 지정합니다. 여러 지역 및 언어 예를 참고하세요.
sameAs URL 강력 추천 이유 프로그램을 식별할 수 있는 참조 웹페이지의 URL 예를 들어 프로그램의 위키백과 페이지가 여기에 해당합니다. 이는 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의 경우 콘텐츠가 게시된 지역입니다.

FeaturedEventExclusiveEvent의 경우 콘텐츠가 추천되거나 독점적인 지역입니다.

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

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

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

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

FeaturedEvent의 경우 제공자가 항목을 표시한 마지막 날짜를 나타냅니다.

콘텐츠가 영구적으로 배타적이거나 추천되는 경우 endDate을 현재 날짜로부터 20년으로 설정합니다.
releasedEvent.publishedBy Organization 또는 Person 선택사항 - 이 항목을 게시한 조직 또는 사람입니다.
description 텍스트 강력 추천 이유 프로그램의 시놉시스입니다. 사실에 기반한 요약보다 줄거리 시놉시스를 사용하는 것이 낫습니다. 글자 수 제한은 300자(영문 기준)입니다.
actor Person, PerformingGroup 또는 PerformanceRole 강력 추천 이유 시리즈의 출연진 배열입니다. 여기에서 모델링 가이드를 참고하세요.
director 사람 강력 추천 이유 프로그램의 감독입니다.
producer Organization 또는 Person 강력 추천 이유 프로그램 제작자입니다.
image ImageObject Google TV에 필수 - TVSeries와 관련된 이미지입니다. image와 함께 포함할 필수 및 선택 속성에 관한 자세한 내용은 이미지 속성을 참고하세요.
trailer.description 텍스트 트레일러 설명입니다. Trailer 예를 참고하세요.
trailer.inLanguage 텍스트 BCP 47 형식의 트레일러 언어입니다.
trailer.url URL 각 프로덕션 스튜디오 또는 공인 소스에서 공개적으로 호스팅되고 업로드된 트레일러의 URL입니다.
trailer.regionsAllowed 장소 미디어가 허용되는 지역입니다. 지정하지 않으면 모든 국가에서 허용되는 것으로 간주됩니다. ISO 3166 형식으로 국가를 지정합니다.
identifier PropertyValue 강력 추천 이유 - 이 항목을 명확하게 식별하는 외부 ID 또는 기타 ID입니다. 여러 식별자를 사용할 수 있습니다. 자세한 내용은 식별자 속성 섹션을 참조하세요.
popularityScore PopularityScoreSpecification 강력 추천 이유 Google에서 사용자에게 재생할 미디어를 결정하는 데 사용하는 점수 및 기타 신호입니다. 이 점수는 카탈로그에 있는 다른 콘텐츠와 비교하여 콘텐츠의 인기도를 나타냅니다. 따라서 점수 척도는 카탈로그의 모든 항목 중에서 피드 전체에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다.
popularityScore.@type 텍스트 항상 PopularityScoreSpecification로 설정합니다.
popularityScore.value 숫자 항목의 인기도를 나타내는 음수가 아닌 숫자 값입니다. 점수가 높을수록 인기도가 높다는 것을 의미합니다.
popularityScore.eligibleRegion 국가 이 인기도 점수가 적용되는 지역입니다. 인기도 점수가 전 세계적으로 적용되는 경우 EARTH로 설정합니다. 기본적으로 이 속성은 EARTH로 설정됩니다.
Note: 언어별 인기도가 전 세계 (EARTH) 인기도보다 우선 적용됨
review 리뷰 TV 시리즈 평점 검토
review.reviewRating 평점 review가 제공된 경우 필수 항목입니다. 리뷰에 부여된 평점을 지정하는 데 사용됩니다.
contentRating Text 또는 Rating 성인용 콘텐츠의 경우 필수사항이며 그 외의 경우에는 적극 권장됨 - 전체 콘텐츠 등급입니다. 콘텐츠 등급이 텍스트 문자열 형식으로 주어진 경우 두 가지 변형이 허용됩니다.
  • 등급 부여 기관이 등급 앞에 공백을 두었습니다. (예: 'TV-MA') 대행사 'TVPG' 등급 'TVPG TV-MA'로 설명되어야 합니다. 대행사 목록을 참고하세요.
  • '등급 알 수 없음' 값 를 사용하세요.
contentRating.author Organization 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 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시켜야 합니다.
url은 다음 요구사항을 충족해야 합니다.
  • url는 전역적으로 고유해야 합니다.
  • url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
재생의 딥 링크target 객체의 urlTemplate 속성을 대신 참고하세요.
name 텍스트 필수 - 에피소드의 이름입니다.
  • 배열을 사용하여 다양한 언어로 된 이름을 나열합니다. 여러 언어 표현 예를 참고하세요.
  • 언어당 하나의 이름만 지원됩니다 (언어-국가 쌍).
titleEIDR 텍스트 강력 추천 이유 - 가장 일반적인/추상적 수준에서 영화 또는 TV 작품을 나타내는 EIDR (Entertainment Identifier Registry) 식별자

예를 들어 '왕좌의 게임'으로 알려진 TVSeries 첫 시즌의 첫 번째 에피소드의 titleEIDR을 입력합니다. '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X'입니다.
editEIDR 텍스트 강력 추천 이유 - 영화 또는 TV 작품의 특정 편집본 / 에디션을 나타내는 EIDR (Entertainment Identifier Registry) 식별자입니다.

예를 들어 '왕좌의 게임'으로 알려진 TVSeries 첫 번째 시즌의 첫 번째 에피소드의 EIDR이 '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X'인 경우 "10.5240/FB97-C847-2969-D0AB-ECD1-C".

editEIDR이 제공된 경우 titleEIDR 속성은 필수입니다.
inLanguage 텍스트 시리즈의 원래 언어이며 BCP 47 형식입니다.
episodeNumber 정수 필수 - 시즌의 에피소드 순서로 이 에피소드의 위치를 나타내는 번호입니다. 시즌마다 episodeNumber을(를) 다시 시작해야 합니다. 즉, 각 시즌의 첫 번째 에피소드가 1이어야 합니다.
partOfSeason TVSeason 필수사항 - 이 에피소드가 속한 TV 시즌입니다.

TVEpisode에 해당하는 TVSeason이 없더라도 partOfSeason.@idpartOfSeason.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 예를 들어 프로그램의 위키백과 페이지가 여기에 해당합니다. 이는 url 속성과 구분되어야 합니다.
potentialAction WatchAction 해당하는 경우 필수 - 작업의 세부정보를 제공하는 Action 마크업 객체
  • 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의 경우 콘텐츠가 게시된 지역입니다.

FeaturedEventExclusiveEvent의 경우 콘텐츠가 추천되거나 독점적인 지역입니다.

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

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

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

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 예를 참고하세요.
trailer.inLanguage 텍스트 BCP 47 형식의 트레일러 언어입니다.
trailer.url URL 각 프로덕션 스튜디오 또는 공인 소스에서 공개적으로 호스팅되고 업로드된 트레일러의 URL입니다.
trailer.regionsAllowed 장소 미디어가 허용되는 지역입니다. 지정하지 않으면 모든 국가에서 허용되는 것으로 간주됩니다. ISO 3166 형식으로 국가를 지정합니다.
review 리뷰 TV 에피소드 평점 검토
review.reviewRating 평점 review가 제공된 경우 필수 항목입니다. 리뷰에 부여된 평점을 지정하는 데 사용됩니다.
contentRating Text 또는 Rating 성인용 콘텐츠의 경우 필수사항이며 그 외의 경우에는 적극 권장됨 - 전체 콘텐츠 등급입니다. 콘텐츠 등급이 텍스트 문자열 형식으로 주어진 경우 두 가지 변형이 허용됩니다.
  • 등급 부여 기관이 등급 앞에 공백을 두었습니다. (예: 'TV-MA') 대행사 'TVPG' 등급 'TVPG TV-MA'로 설명되어야 합니다. 대행사 목록을 참고하세요.
  • '등급 알 수 없음' 값 를 사용하세요.
contentRating.author Organization contentRating님이 Rating을(를) 사용하는 경우 필수: 등급 부여 기관의 이름입니다. 허용되는 등급 부여 기관 목록은 콘텐츠 등급 부여 기관 페이지를 참조하세요.
contentRating.ratingValue 텍스트 contentRating에서 Rating을 사용하는 경우 필수: 평점의 값입니다.
contentRating.advisoryCode 텍스트 콘텐츠의 자문 코드입니다. 허용되는 값은 D, FV, L, S, V입니다. D = 대화, FV = 판타지 폭력 , L = 언어, S = 성적인 콘텐츠, V = 폭력
identifier PropertyValue 강력 추천 이유 - 이 항목을 명확하게 식별하는 외부 ID 또는 기타 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 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시켜야 합니다.
url은 다음 요구사항을 충족해야 합니다.
  • url는 전역적으로 고유해야 합니다.
  • url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
재생의 딥 링크target 객체의 urlTemplate 속성을 대신 참고하세요.
name 텍스트 필수사항 - 이 TV 시즌의 이름입니다.
  • 배열을 사용하여 다양한 언어로 된 이름을 나열합니다. 여러 언어 표현 예를 참고하세요.
  • 언어당 하나의 이름만 지원됩니다 (언어-국가 쌍).
titleEIDR 텍스트 강력 추천 이유 - 가장 일반적인/추상적 수준에서 영화 또는 TV 작품을 나타내는 EIDR (Entertainment Identifier Registry) 식별자

예를 들어 '왕좌의 게임'으로 알려진 TVSeries 첫 시즌의 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 예를 들어 프로그램의 위키백과 페이지가 여기에 해당합니다. 이는 url 속성과 구분되어야 합니다.
potentialAction WatchAction 해당하는 경우 필수 - 작업의 세부정보를 제공하는 Action 마크업 객체
  • VOD로 콘텐츠를 사용할 수 있는 경우 이 속성은 필수입니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • LiveTV 채널에서 콘텐츠를 사용할 수 있는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 채널의 딥 링크를 대신 제공합니다.
  • TVSeason는 VoD와 LiveTV에서 모두 사용할 수 있습니다.
배열을 사용하여 여러 지역에 서로 다른 딥 링크를 지정합니다. 여러 지역 및 언어 예를 참고하세요.
sameAs URL 강력 추천 이유 시즌을 식별할 수 있는 참조 웹페이지의 URL 예를 들어 해당 시즌의 위키백과 페이지 등입니다. 이는 url 속성과 구분되어야 합니다.
releasedEvent PublicationEvent, FeaturedEvent, ExclusiveEvent 강력 추천 이유 - PublicationEvent은 영화의 원본 극장 개봉 날짜와 같이 게시자가 콘텐츠를 원본 (전 세계 또는 현지) 출시할 때 지정합니다.

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

ExclusiveEvent는 서비스에 독점 배포 권한이 있으며 배포 위치와 시기가 포함되어 있음을 명시합니다.

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

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

FeaturedEventExclusiveEvent의 경우 콘텐츠가 추천되거나 독점적인 지역입니다.

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

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

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

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

FeaturedEvent의 경우 제공자가 항목을 표시한 마지막 날짜를 나타냅니다.

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

배열을 사용하여 여러 Person,PerformingGroups 또는 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 예: 배우의 위키백과 페이지 이는 @id 속성과 구분되어야 합니다.

PerformanceRole 유형 사용

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

속성 예상 유형 설명
@type PerformanceRole 필수 - 항상 PerformanceRole로 설정
roleName 텍스트 강력 추천 이유 - 출연진이 연기하거나 연기하거나 채운 역할입니다. 여기에서 사용 가능한 값 목록을 확인하세요.
characterName 텍스트 특정 연기 또는 공연을 한 등장인물의 이름입니다. 행위자 유형이 PerformingGroup인 경우에는 이 필드를 설정하지 마세요.
actor Person 또는 PerformingGroup 필수 -
  • 데이터 유형 Person이 사용된 경우 콘텐츠의 캐스트 멤버입니다.
  • 데이터 유형 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 예: 배우의 위키백과 페이지 actor.@id 속성과 구분되어야 합니다.

허용되는 역할 이름

이 값을 사용하려면 actor.@typePerson여야 합니다.

roleName 설명
'Cameo' 카메오 역할(카메오 출연이라고도 함)은 공연 예술 작품에서 유명 인사가 짧게 등장하는 것을 말합니다.
"VoiceActor" 음성 연기는 배우의 음성이 사용되지만 화면에 나타나지 않는 공연입니다. 이는 애니메이션에서 가장 흔히 볼 수 있지만 배우의 음성이 다른 배우의 연설 위에 더빙된 경우에도 발생합니다.
"더블" double은 얼굴을 드러내지 않도록 다른 배우를 대체하는 사람입니다.
"MotionCaptureActor" MotionCaptureActor는 사람 배우의 동작을 녹화하고 이 정보를 사용하여 2D 또는 3D 컴퓨터 애니메이션에서 디지털 캐릭터 모델을 애니메이션화하는 사람을 의미합니다.

이 값은 일반적으로 PersonPerformingGroup 유형에서 허용됩니다.

roleName 설명
"배우" 배우란 연극의 전통적인 매체나 영화, 라디오, TV와 같은 현대 미디어에서 등장인물을 연기하는 사람입니다.
'GuestStar' "게스트 스타는 한두 편의 에피소드에 출연하는 가상의 역할을 하는 배우입니다. 경우에 따라 게스트 스타가 자주 등장하는 중요한 캐릭터를 연기하고 주요 출연진이 아니더라도 시리즈에 여러 번 등장할 수 있습니다. 값을 'GuestStar'로 설정합니다. 출연진이 객원 연기를 하거나 프로그램에 게스트로 임할 때 게스트 스타는 에피소드 수준에서만 제공되어야 하며 TVSeries 수준에서는 추가해서는 안 됩니다.
'게스트' "토크쇼에 게스트가 있어요. 'GuestStar'는 '게스트'는 가상의 역할입니다. 가상의 인물이 아닙니다.
"아나운서" 아나운서는 쇼의 시작 및 마무리 광고를 전달하고, 진행자, 참가자 및/또는 유명인 게스트를 소개하고, 받을 수 있는 상품에 대해 설명하며, 녹화 전에 시청자를 워밍업하고 휴식 시간에는 즐거움을 주는 사람입니다.
"해설자" 해설자는 보통 라이브 방송 중에 게임이나 이벤트에 대한 실시간 해설을 제공합니다.
'인상파' 인상파 또는 모방은 유명인 및 만화 캐릭터의 소리, 목소리, 버릇을 흉내내는 공연자입니다.
'호스트' TV 프로그램을 소개, 발표 또는 진행하는 사람으로 프로그램과 시청자의 중재자 역할을 하기도 합니다. '호스트' 일반적으로 논픽션 역할입니다
'공동 호스트' 다른 사람과 함께 이벤트/프로그램을 주최하는 사람입니다.
'GuestHost' 게스트 호스트는 일반적으로 토크쇼의 호스트로, 참여할 수 없는 경우 일반 호스트 대신 프로그램을 진행합니다.
"뉴스캐스터" TV 뉴스 프로그램을 통해 지역, 국가, 국제적 규모로 일어나는 뉴스와 사건을 대중에게 발표하거나 알리는 사람입니다.
"담당자" 기자 또는 현장 기자는 일반적으로 잡지의 기자 또는 해설자이거나 먼 위치에서 종종 먼 위치에서 신문, 라디오, TV 뉴스 또는 다른 유형의 회사에 보도하는 대리인입니다.
"ShowJudge" 판사는 프로그램 분야에서 전문가로 간주되는 경우가 많으며 '심사' 역할을 하는 사람입니다. 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"
      }
  }
]

일부 배우의 알려진 역할

공연 역할 메타데이터를 알 수 없는 경우 Person 또는 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"
  }
]

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