이 섹션에서는 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 | 해당하는 경우 필수 - 작업의 세부정보를 제공하는 Action 마크업 객체
|
sameAs |
URL | 강력 추천 이유 영화를 식별할 수 있는 참조 웹페이지의 URL 영화의 위키백과 페이지를 예로 들 수 있습니다. 이는 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 예를 참고하세요. |
trailer.inLanguage |
텍스트 | BCP 47 형식의 트레일러 언어입니다. |
trailer.url |
URL | 각 프로덕션 스튜디오 또는 공인 소스에서 공개적으로 호스팅되고 업로드된 트레일러의 URL입니다. |
trailer.regionsAllowed |
장소 | 미디어가 허용되는 지역입니다. 지정하지 않으면 모든 국가에서 허용되는 것으로 간주됩니다. ISO 3166 형식으로 국가를 지정합니다. |
identifier |
PropertyValue | 강력 추천 이유 - 이 항목을 명확하게 식별하는 외부 ID 또는 기타 ID입니다. 여러 식별자를 사용할 수 있습니다. 자세한 내용은 식별자 속성 섹션을 참조하세요. |
review |
리뷰 | 영화 리뷰 평점 |
review.reviewRating |
평점 | 검토가 제공되는 경우 필수 항목입니다. 리뷰에 부여된 평점을 지정하는 데 사용됩니다. |
contentRating |
Text 또는 Rating | 성인용 콘텐츠의 경우 필수사항이며 다른 경우에는 적극 권장됩니다. 이유 - 전체 콘텐츠 등급. 콘텐츠 등급이 텍스트 문자열 형식으로 주어진 경우 두 가지 변형이 허용됩니다.
|
contentRating.author |
Text 또는 Organization | 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"
}
관련 페이지
이러한 속성과 관련된 주제는 다음 페이지를 확인하세요.