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이 포함되어야 합니다.
재생의 딥 링크타겟 객체의 urlTemplate 속성을 대신 참고하세요.
name 텍스트 필수 - 프로그램의 이름입니다.
  • 배열을 사용하여 여러 언어로 이름을 나열합니다. 여러 지역 및 언어 예시를 참고하세요.
  • 언어-국가 쌍별로 하나의 이름만 지원됩니다.
titleEIDR 텍스트 적극 권장이유 - 가장 일반적/추상적 수준에서 영화 또는 TV 작품을 나타내는 EIDR (Entertainment Identifier Registry) 식별자

예를 들어 '왕좌의 게임'으로 알려진 TV 시리즈의 titleEIDR은 '10.5240/C1B5-3BA1-8991-A571-8472-W'입니다.
potentialAction WatchAction 해당하는 경우 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다.
  • 콘텐츠가 주문형 비디오 (VoD)에서 제공되는 경우 이 속성이 필요합니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • 콘텐츠가 라이브 TV 채널에서 제공되는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 대신 채널의 딥 링크를 제공합니다.
  • TVSeries는 VOD와 LiveTV 모두에서 사용할 수 있습니다.
배열을 사용하여 여러 지역에서 서로 다른 딥 링크를 지정합니다. 여러 지역 및 언어 예시를 참고하세요.
sameAs URL 적극 권장이유 프로그램을 식별할 수 있는 참조 웹페이지의 URL입니다(예: 프로그램의 Wikipedia 페이지). 이 값은 url 속성과 달라야 합니다.
inLanguage 텍스트 매우 권장 시리즈의 원본 언어입니다(BCP 47 형식).
genre 텍스트 모든 관련 장르의 순서가 지정된 목록입니다. 예 : ["Action", "Fashion", "Environment", "Football"]
keywords 텍스트 이 콘텐츠를 설명하는 데 사용되는 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ["특집, 전기"] 는 콘텐츠를 설명하는 키워드 배열일 수 있습니다.
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 Person 적극 권장이유 프로그램의 감독입니다.
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 조직 contentRatingRating을 사용하는 경우 필수 - 등급 기관의 이름입니다. 허용되는 등급 부여 기관 목록은 콘텐츠 등급 부여 기관 페이지를 참고하세요.
contentRating.ratingValue 텍스트 contentRatingRating를 사용하는 경우 필수 - 등급 값입니다.
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이 포함되어야 합니다.
재생의 딥 링크타겟 객체의 urlTemplate 속성을 대신 참고하세요.
name 텍스트 필수 - 에피소드 이름입니다.
  • 배열을 사용하여 여러 언어로 이름을 나열합니다. 다국어 표현 예시를 참고하세요.
  • 언어-국가 쌍별로 하나의 이름만 지원됩니다.
titleEIDR 텍스트 적극 권장이유 - 가장 일반적/추상적 수준에서 영화 또는 TV 작품을 나타내는 EIDR (Entertainment Identifier Registry) 식별자

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

예를 들어 타이틀 EIDR이 '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X'인 TV 시리즈 '왕좌의 게임'의 첫 번째 시즌 첫 번째 에피소드에는 '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입니다(예: 프로그램의 Wikipedia 페이지). 이 값은 url 속성과 달라야 합니다.
potentialAction WatchAction 해당하는 경우 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다.
  • 콘텐츠가 주문형 비디오 (VoD)에서 제공되는 경우 이 속성이 필요합니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • 콘텐츠가 라이브 TV 채널에서 제공되는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 대신 채널의 딥 링크를 제공합니다.
  • TVEpisode는 VOD와 LiveTV 모두에서 사용할 수 있습니다.
배열을 사용하여 여러 지역에서 서로 다른 딥 링크를 지정합니다. 여러 지역 및 언어 예시를 참고하세요.
sameAs 적극 권장이유 URL 에피소드를 식별할 수 있는 참조 웹페이지의 URL입니다(예: 에피소드의 Wikipedia 페이지). 이 값은 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 텍스트 이 콘텐츠를 설명하는 데 사용되는 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ["특집, 전기"] 는 콘텐츠를 설명하는 키워드 배열일 수 있습니다.
actor Person 또는 PerformingGroup 또는 PerformanceRole 적극 권장이유 에피소드의 출연진 배열입니다. 여기에서 모델링 안내를 확인하세요.
director Person 적극 권장이유 에피소드의 감독입니다.
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 조직 contentRatingRating을 사용하는 경우 필수 - 등급 기관의 이름입니다. 허용되는 등급 부여 기관 목록은 콘텐츠 등급 부여 기관 페이지를 참고하세요.
contentRating.ratingValue 텍스트 contentRatingRating를 사용하는 경우 필수 - 등급 값입니다.
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 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시킵니다.
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)에서 제공되는 경우 이 속성이 필요합니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • 콘텐츠가 라이브 TV 채널에서 제공되는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 대신 채널의 딥 링크를 제공합니다.
  • TVSeason는 VOD와 LiveTV 모두에서 사용할 수 있습니다.
배열을 사용하여 여러 지역에서 서로 다른 딥 링크를 지정합니다. 여러 지역 및 언어 예시를 참고하세요.
sameAs URL 적극 권장이유 시즌을 식별할 수 있는 참조 웹페이지의 URL입니다(예: 시즌의 Wikipedia 페이지). 이 값은 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 Person 적극 권장이유 프로그램의 감독 배열입니다.
producer Organization 또는 Person 적극 권장이유 시즌의 프로듀서입니다.
image ImageObject TV 시즌과 관련된 이미지입니다. image에 포함할 필수 및 선택 속성에 관한 자세한 내용은 이미지 속성을 참고하세요.
genre 텍스트 모든 관련 장르의 순서가 지정된 목록입니다. 예 : ["Action", "Fashion", "Environment", "Football"]
keywords 텍스트 이 콘텐츠를 설명하는 데 사용되는 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ["특집, 전기"] 는 콘텐츠를 설명하는 키워드 배열일 수 있습니다.
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 조직 contentRatingRating을 사용하는 경우 필수 - 등급 기관의 이름입니다. 허용되는 등급 부여 기관 목록은 콘텐츠 등급 부여 기관 페이지를 참고하세요.
contentRating.ratingValue 텍스트 contentRatingRating를 사용하는 경우 필수 - 등급 값입니다.
contentRating.advisoryCode 텍스트 콘텐츠의 경고 코드입니다. 허용되는 값은 D, FV, L, S, V입니다. D = 대화, FV = 판타지 폭력 , L = 언어, S = 성적 콘텐츠, V = 폭력

작업 수행자 사양

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

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

배열을 사용하여 여러 Person, PerformingGroup 또는 PerformanceRole을 나타냅니다.

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 필수 -
  • 데이터 유형 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(예: 배우의 Wikipedia 페이지) 이는 actor.@id 속성과 달라야 합니다.

허용되는 역할 이름

이러한 값에는 actor.@typePerson이어야 합니다.

roleName 설명
'카메오' 카메오 역할은 카메오 출연이라고도 하며, 공연 예술 작품에 유명인이 잠깐 출연하는 것입니다.
'VoiceActor' 성우 연기는 배우의 목소리가 사용되지만 배우가 화면에 표시되지 않는 연기입니다. 이러한 현상은 애니메이션에서 가장 흔하게 나타나지만, 배우의 음성이 다른 배우의 음성에 더빙되는 경우에도 발생합니다.
'Double' 더블은 다른 배우를 대신하여 얼굴이 표시되지 않도록 하는 사람입니다.
'MotionCaptureActor' MotionCaptureActor는 인간 배우의 동작을 녹화하고 이 정보를 사용하여 2D 또는 3D 컴퓨터 애니메이션에서 디지털 캐릭터 모델을 애니메이션으로 만드는 사람을 의미합니다.

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

roleName 설명
'배우' 배우는 전통적인 연극 매체나 영화, 라디오, 텔레비전과 같은 현대적인 매체에서 공연을 통해 등장인물을 연기하는 사람입니다.
'GuestStar' '게스트 스타는 허구의 역할을 연기하며 한두 개의 에피소드에 출연하는 배우입니다. 게스트 스타가 중요한 반복 캐릭터를 연기하고 메인 출연진에 속하지 않음에도 불구하고 시리즈에 여러 번 등장하는 경우도 있습니다. 출연진이 게스트로 출연하거나 게스트로 출연하는 경우 값을 'GuestStar'로 설정합니다. 게스트 스타는 에피소드 수준에서만 제공되어야 하며 TVSeries 수준에서는 추가하면 안 됩니다.
'게스트' "토크쇼 게스트. 'GuestStar'는 가상의 역할이지만 'Guest'는 가상이 아닌 출연입니다.
'Announcer' 아나운서는 프로그램의 오프닝 및 클로징 멘트를 전달하고, 호스트, 참가자, 유명인 게스트를 소개하고, 제공되는 상품을 설명하고, 녹화 전에 청중을 워밍업하고 휴식 시간 동안 청중을 즐겁게 해주는 사람입니다.
'Commentator' 해설자는 일반적으로 라이브 방송 중에 경기나 이벤트에 대한 실시간 해설을 제공합니다.
'인상주의' 성대모사 연기자는 유명인과 만화 캐릭터의 소리, 목소리, 매너리즘을 모방하는 공연자입니다.
'호스트' 텔레비전 프로그램을 소개하거나, 진행하거나, 호스팅하는 사람으로, 프로그램과 시청자 사이의 중재자 역할을 하는 경우가 많습니다. '호스트'는 일반적으로 논픽션 역할입니다.
'CoHost' 다른 사람과 공동으로 이벤트/프로그램을 주최하는 사람입니다.
'GuestHost' 게스트 호스트는 일반적으로 토크쇼의 호스트로, 정규 호스트가 참석할 수 없을 때 프로그램을 진행합니다.
'뉴스 캐스터' TV 뉴스 프로그램을 통해 지역, 국내, 국제적으로 일어나는 뉴스 및 사건에 관해 대중에게 설명하는 사람입니다.
'Correspondent' 특파원 또는 현장 기자는 보통 잡지의 저널리스트 또는 해설자이거나, 신문, 라디오 또는 텔레비전 뉴스 또는 다른 유형의 회사에 원격(종종 먼) 위치에서 보도를 제공하는 에이전트입니다.
'ShowJudge' 심사위원은 프로그램 분야의 전문가로 간주되는 사람으로, 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"
  }
]

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