이 섹션에서는 Movie 항목 유형의 콘텐츠 마크업 속성에 관해 자세히 설명합니다.
사양 표
| 속성 | 예상 유형 | 설명 |
|---|---|---|
@context |
텍스트 | 필수 - 항상 ["http:/로 설정
|
@type |
텍스트 | 필수 - 영화의 경우 항상 Movie로 설정합니다. |
@id |
URL | 필수 - 콘텐츠의 식별자(URI 형식)입니다(예: https://example.com/1234abc).@id는 다음 요구사항을 충족해야 합니다.
url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url을 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요. |
url |
URL | 필수 - Google에서 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시키는 데 사용하는 콘텐츠의 표준 URL입니다.url은 다음 요구사항을 충족해야 합니다.
urlTemplate 속성을 참고하세요. |
name |
텍스트 | 필수 - 영화의 이름입니다.
|
titleEIDR |
텍스트 | 적극 권장됨 이유 - 영화 또는 TV 저작물을 가장 일반적이고 추상적인 수준에서 나타내는 EIDR (Entertainment Identifier Registry) 식별자입니다. 예를 들어 '고스트버스터즈'라는 영화의 titleEIDR은 '10.5240/7EC7-228A-510A-053E-CBB8-J'입니다. |
editEIDR |
텍스트 | 적극 권장됨 이유 - 영화 또는 TV 저작물의 특정 수정 / 버전을 나타내는 EIDR (Entertainment Identifier Registry) 식별자입니다. 예를 들어 'Ghostbusters'라는 영화의 titleEIDR이 '10.5240/7EC7-228A-510A-053E-CBB8-J'인 경우 여러 편집본(예: '10.5240/1F2A-E1C5-680A-14C6-E76B-I' 및 '10.5240/8A35-3BEE-6497-5D12-9E4F-3')이 있습니다. editEIDR가 제공된 경우 titleEIDR 속성이 필수입니다. |
potentialAction |
WatchAction | 해당하는 경우 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다.
|
sameAs |
URL | 적극 권장됨 이유 영화를 식별할 수 있는 참조 웹페이지의 URL입니다(예: 영화의 Wikipedia 페이지). 이 값은 url 속성과 구분되어야 합니다. |
inLanguage |
텍스트 | 영화의 원래 언어입니다(BCP 47 형식). |
genre |
텍스트 | 모든 관련 장르의 순서가 지정된 목록입니다. 예 : ['액션', '패션', '환경', '축구'] |
keywords |
텍스트 | 이 콘텐츠를 설명하는 데 사용된 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ["feature, biography"] 는 콘텐츠를 설명하는 키워드 배열일 수 있습니다. |
releasedEvent |
PublicationEvent, FeaturedEvent 또는 ExclusiveEvent |
적극 권장됨 이유 - PublicationEvent는 영화의 원래 극장 개봉일과 같이 게시자가 콘텐츠의 원래 (전 세계 또는 지역) 발표를 지정하는 데 사용됩니다.또한 FeaturedEvent를 사용하여 서비스에서 이 콘텐츠를 오리지널, 추천, 스페셜 등으로 마케팅하고 있음을 나타냅니다.ExclusiveEvent는 서비스에 배타적인 배급 권리가 있음을 지정하고 배급 지역과 시기를 포함합니다.자세한 내용과 예시는 예시 섹션을 참고하세요. |
releasedEvent.@type |
텍스트 | 필수 - 이 속성은 항상 다음 중 하나로 설정해야 합니다.
|
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자(영문 기준)로 제한됩니다.
|
duration |
기간 | 영화의 런타임이며 ISO 8601 형식으로 나타냅니다. 'PT00H00M' 형식을 사용하세요. |
director |
사람 | 적극 권장됨 이유 영화의 감독입니다. |
actor |
사람 | 적극 권장됨 이유 영화의 출연자입니다. |
producer |
Organization 또는 Person | 적극 권장됨 이유 영화의 제작자입니다. |
image |
ImageObject | Google TV에 필요 - 영화와 관련된 이미지입니다. image에 포함할 필수 및 선택 속성에 관한 자세한 내용은 이미지 속성을 참고하세요. |
trailer.description |
텍스트 | 트레일러에 대한 설명입니다. 트레일러 예를 참고하세요. |
trailer.inLanguage |
텍스트 | 트레일러의 언어입니다(BCP 47 형식). |
trailer.url |
URL | 각 제작 스튜디오 또는 승인된 소스에서 공개적으로 호스팅하고 업로드한 트레일러의 URL입니다. |
trailer.regionsAllowed |
장소 | 미디어가 허용되는 지역입니다. 지정하지 않으면 모든 지역에서 허용되는 것으로 간주됩니다. ISO 3166 형식으로 국가를 지정합니다. |
identifier |
PropertyValue | 적극 권장됨 이유 - 이 항목을 명확하게 식별하는 외부 또는 기타 ID입니다. 여러 식별자가 허용됩니다. 자세한 내용은 식별자 속성 섹션을 참고하세요. |
review |
리뷰 | 영화 평점 검토 |
review.reviewRating |
평점 | 리뷰가 제공되는 경우 필수입니다. 리뷰에 주어진 평점을 지정하는 데 사용됩니다. |
contentRating |
Text 또는 Rating | 성인용 콘텐츠의 경우 필수사항이며, 그렇지 않은 경우 권장사항입니다. 이유 - 전체 콘텐츠 등급 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 다음 두 가지 변형이 허용됩니다.
|
contentRating.author |
조직 | contentRating에서 Rating를 사용하는 경우 필요 - 신용 평가 기관의 이름입니다. |
contentRating.ratingValue |
텍스트 | contentRating가 Rating를 사용하는 경우 필요 - 평점 값입니다. |
contentRating.advisoryCode |
텍스트 | 콘텐츠의 고지 코드입니다. 허용되는 값은 D, FV, L, S, V입니다. D = 대화, FV = 판타지 폭력 , L = 언어, S = 성적인 콘텐츠, V = 폭력 |
popularityScore |
PopularityScoreSpecification | 적극 권장됨 이유 Google에서 사용자에게 재생할 미디어를 결정하기 위해 사용하는 점수와 기타 신호입니다. 이 점수는 카탈로그의 다른 콘텐츠와 비교한 콘텐츠의 인기도를 나타냅니다. 따라서 점수의 크기는 카탈로그의 모든 항목 간에 피드에서 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정됩니다. |
popularityScore.@type |
텍스트 | 항상 PopularityScoreSpecification로 설정합니다. |
popularityScore.value |
숫자 | 항목의 인기도를 나타내는 비음수 숫자 값입니다. 점수가 높을수록 인기도가 높습니다. |
popularityScore.eligibleRegion |
국가 | 이 인기 점수가 적용되는 지역입니다. 인기 점수가 전 세계적으로 적용되는 경우 EARTH로 설정합니다. 기본적으로 이 속성은 EARTH로 설정됩니다. Note: 언어별 인기도가 전 세계 (EARTH) 인기도보다 우선 적용됩니다. |
category |
텍스트 | 해당하는 경우 필수 - 항목이 Movie 변형인 경우 이 속성을 채웁니다. category를 다음 중 하나로 설정합니다.
|
workExample |
영화 | 필름의 변형을 지정합니다. 이 속성은 변형 버전의 Movie 항목이 아닌 기본 Movie 항목에 포함합니다. |
workExample.@id |
URL | Movie 변형의 경우 이 속성은 이 변형의 Movie 항목의 @id를 제공합니다. |
workExample.@type |
텍스트 | 필수 - 항상 Movie로 설정합니다. 이는 여러 대안이 있는 Movie의 배열로 표현할 수 있습니다. |
workExample.@id |
URL | 필수 - Movie 변형의 @id입니다. |
workExample.name |
텍스트 | 필수 - Movie 변형의 이름입니다. |
workExample.category |
텍스트 | 필수 - 특정 버전의 필름 변형 유형입니다. 카테고리를 다음 중 하나로 설정합니다.
|
예
확장판 버전이 있는 영화입니다.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"name": "My Favorite Movie",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
"contentRating": "RATING NOT KNOWN",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"workExample": {
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut"
"category": "Extended Cut"
}
}
기본 영화의 확장판 버전입니다.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"url": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package",
"identifier": "example.com:example_package"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
"contentRating": {
"@type": "Rating",
"author": "MPAA",
"ratingValue": "R",
"advisoryCode": "FV"
},
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "This is the extended cut of my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"exampleOfWork": {
"@id": "http://www.example.com/my_favorite_movie",
}
"category": "Extended Cut"
}
관련 페이지
이러한 속성과 관련된 주제는 다음 페이지를 참고하세요.