이 섹션에서는 Movie 항목 유형의 콘텐츠 마크업 속성에 관한 세부정보를 제공합니다.
사양 표
| 속성 | 예상 유형 | 설명 |
|---|---|---|
@context |
텍스트 | 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
|
@type |
텍스트 | 필수 - 영화의 경우 항상 Movie로 설정합니다. |
@id |
URL | 필수 - URI 형식의 콘텐츠 식별자입니다(예: https://example.com/1234abc).@id는 다음 요구사항을 충족해야 합니다:
url이 식별자로서 모든 요구사항을 충족하므로 항목의 url을 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요. |
url |
URL | 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시킵니다.url은 다음 요구사항을 충족해야 합니다.
urlTemplate 속성을 참고하세요. |
name |
텍스트 | 필수 - 영화의 이름입니다.
|
titleEIDR |
텍스트 | 매우 권장하는 이유 - 가장 일반적/추상적인 수준에서 영화 또는 TV 저작물을 나타내는 EIDR (Entertainment Identifier Registry) 식별자입니다. 예를 들어 '고스트버스터즈'라는 영화의 titleEIDR은 '10.5240/7EC7-228A-510A-053E-CBB8-J'입니다. |
editEIDR |
텍스트 | 매우 권장하는 이유 - 영화 또는 TV 저작물의 특정 편집 / 판본을 나타내는 EIDR (Entertainment Identifier Registry) 식별자입니다. 예를 들어 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'과 같은 여러 편집이 있습니다. titleEIDR 속성은 editEIDR이 제공되면 필수 입니다. |
potentialAction |
WatchAction | 해당하는 경우 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다.
|
sameAs |
URL | 매우 권장하는 이유 영화를 식별할 수 있는 참조 웹페이지의 URL입니다(예: 영화의 Wikipedia 페이지). 이 속성은 url 속성과 달라야 합니다. |
inLanguage |
텍스트 | 매우 권장 BCP 47 형식의 영화 원어입니다. |
genre |
텍스트 | 모든 관련 장르의 정렬된 목록입니다. 예 : ['액션', '패션', '환경', '축구'] |
keywords |
텍스트 | 이 콘텐츠를 설명하는 데 사용되는 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ['특집, 전기']는 콘텐츠를 설명하는 키워드 배열일 수 있습니다. |
releasedEvent |
PublicationEvent, FeaturedEvent 또는 ExclusiveEvent |
매우 권장하는 이유 - PublicationEvent는 영화의 최초 극장 개봉일과 같이 게시자가 콘텐츠를 최초로 (전역 또는 로컬) 공개하는 것을 지정하는 데 사용됩니다.또한 FeaturedEvent를 사용하여 서비스에서 이 콘텐츠를 오리지널, 특집, 스페셜 등으로 마케팅함을 나타냅니다.ExclusiveEvent는 서비스에 독점 배포권이 있으며 위치와 시간을 포함함을 지정합니다.자세한 내용과 예시는 예시 섹션을 참고하세요. |
releasedEvent.@type |
텍스트 | 필수 - 항상 이 속성을 다음 중 하나로 설정해야 합니다.
|
releasedEvent.location |
국가 | 필수 - 이 이벤트와 연결된 지역입니다.PublicationEvent의 경우 콘텐츠가 게시된 지역입니다.FeaturedEvent 및 ExclusiveEvent의 경우 콘텐츠가 추천 또는 독점인 지역입니다.국가에는 ISO 3166 코드를 사용합니다. 전 세계를 나타내려면 EARTH로 설정합니다. |
releasedEvent.startDate |
날짜 또는 DateTime | 권장 - ExclusiveEvent에 필요 - 항목 공개의 시작일입니다.PublicationEvent의 경우 영화가 처음 극장에서 개봉된 날짜와 같이 이 항목의 최초 공개일을 나타냅니다.ExclusiveEvent 및 FeaturedEvent의 경우 항목이 독점 또는 특집으로 제공되는 시작일을 나타냅니다. |
releasedEvent.endDate |
날짜 또는 DateTime | 권장 - ExclusiveEvent에 필요 - ExclusiveEvent 및 FeaturedEvent 유형에만 적용됩니다.ExclusiveEvent의 경우 콘텐츠에 대한 권리가 만료되는 날짜를 나타냅니다.FeaturedEvent의 경우 제공업체가 항목을 특집으로 제공하는 마지막 날짜를 나타냅니다.콘텐츠가 영구적으로 독점 또는 특집으로 제공되는 경우 endDate를 현재 날짜로부터 20년 후로 설정합니다. |
releasedEvent.publishedBy |
조직 또는 Person | 선택사항 - 이 항목을 게시한 조직 또는 개인입니다. |
description |
텍스트 | 매우 권장하는 이유 영화의 시놉시스입니다. 사실 요약보다는 줄거리 시놉시스가 더 좋습니다. 글자 수 제한은 최대 300자(영문 기준)입니다.
|
duration |
기간 | ISO 8601 형식의 영화 상영 시간입니다. 'PT00H00M' 형식을 사용하세요. |
director |
Person | 매우 권장하는 이유 영화의 감독입니다. |
actor |
Person | 매우 권장하는 이유 영화의 출연진입니다. |
producer |
조직 또는 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 |
텍스트 또는 평점 | 성인용 콘텐츠의 경우 필수이며, 그 외의 경우 매우 권장하는 이유 - 전반적인 콘텐츠 등급입니다. 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 두 가지 변형이 허용됩니다.
|
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 | 필수 - @id 옵션의 Movie입니다. |
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"
}
관련 페이지
이러한 속성과 관련된 주제는 다음 페이지를 참고하세요.