이 섹션에서는 Movie 항목 유형의 콘텐츠 마크업 속성에 대해 자세히 설명합니다.
사양 표
| 속성 | 예상 유형 | 설명 |
|---|---|---|
@context |
텍스트 | 필수 - 항상 ["http://schema.org", {"@language": "xx"}]로 설정
|
@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) 식별자입니다. 예를 들어 '고스트버스터즈'라고 알려진 영화의 제목 EIDR은 '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-14-6, E7, E6, E6, E6, E7 및 6C, E6, 72E, 74C6, E6, E6, E6, E6, E7, E6, E7, E7, E7, 6G, 8C, 7C, E8, 7F, 8C, 8C, 9C, 9C, 9C, 9C, 9C, 12, 7,2,6,0,4,6,4,6316-84 및 74번가에 위치해 있습니다. editEIDR이 제공된 경우 titleEIDR 속성이 필요합니다. |
potentialAction |
WatchAction | 해당하는 경우 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다.
|
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.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 |
인기도 사양 | 적극 권장되는 이유 Google이 사용자에게 표시할 미디어를 결정하는 데 사용하는 점수 및 기타 신호입니다. 이 점수는 카탈로그에 있는 다른 콘텐츠와 비교하여 해당 콘텐츠가 얼마나 인기 있는지 보여줍니다. 따라서 점수의 척도는 피드 전반에서 카탈로그의 모든 항목 간에 일관되어야 합니다. 기본적으로 항목의 인기도 점수는 0으로 설정되어 있습니다. |
popularityScore.@type |
텍스트 | 항상 PopularityScoreSpecification로 설정합니다. |
popularityScore.value |
Number | 항목의 인기도를 나타내는 음수가 아닌 숫자 값입니다. 점수가 높을수록 인기가 높습니다. |
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"
}
관련 페이지
이러한 속성과 관련된 주제는 다음 페이지를 확인하세요.