이 섹션에서는 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) 식별자 예를 들어 제목 EIDR이 '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 |
텍스트 | 이 콘텐츠를 설명하는 데 사용되는 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ["특집, 전기"] 는 콘텐츠를 설명하는 키워드 배열일 수 있습니다. |
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 |
Person | 적극 권장이유 영화의 감독입니다. |
actor |
Person | 적극 권장이유 영화의 출연진입니다. |
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"
}
관련 페이지
이러한 속성과 관련된 주제는 다음 페이지를 참고하세요.