영화의 콘텐츠 마크업 속성

이 섹션에서는 Movie 항목 유형의 콘텐츠 마크업 속성에 관해 자세히 설명합니다.

사양 표

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
로 설정
  • 여기서 'xx'는 피드의 문자열 언어를 나타냅니다. 각 루트 항목 컨텍스트의 @language는 BCP 47 형식의 적절한 언어 코드로 설정되어야 합니다. 예를 들어 언어가 스페인어로 설정된 경우 자막/더빙 언어가 영어로 되어 있더라도 이름은 스페인어로 간주됩니다.
@type 텍스트 필수 - 영화의 경우 항상 Movie로 설정합니다.
@id URL 필수 - 콘텐츠의 식별자(URI 형식)입니다(예: https://example.com/1234abc).
@id는 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전반에서 고유함
  • 정적: ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다 (프로그램의 URL 속성이 변경되더라도). 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유해야 합니다.
항목의 url은 식별자로서의 모든 요구사항을 충족하므로 항목의 url을 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
url URL 필수 - Google에서 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시키는 데 사용하는 콘텐츠의 표준 URL입니다.
url은 다음 요구사항을 충족해야 합니다.
  • url은 전역적으로 고유해야 합니다.
  • 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) 식별자입니다.

예를 들어 '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 해당하는 경우 필수 - 작업의 세부정보를 제공하는 작업 마크업 객체입니다.
  • 콘텐츠를 VOD (주문형 동영상)에서 사용할 수 있는 경우 이 속성이 필요합니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • 콘텐츠를 LiveTV 채널에서 사용할 수 있는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 대신 채널의 딥 링크를 제공합니다.
  • Movie는 VoD와 LiveTV에서 모두 사용할 수 있습니다.
배열을 사용하여 여러 리전에서 서로 다른 딥 링크를 지정합니다. 여러 리전 및 언어 예시를 참고하세요.
sameAs URL 적극 권장됨 이유 영화를 식별할 수 있는 참조 웹페이지의 URL입니다(예: 영화의 Wikipedia 페이지). 이 값은 url 속성과 구분되어야 합니다.
inLanguage 텍스트 영화의 원래 언어입니다(BCP 47 형식).
genre 텍스트 모든 관련 장르의 순서가 지정된 목록입니다. 예 : ['액션', '패션', '환경', '축구']
keywords 텍스트 이 콘텐츠를 설명하는 데 사용된 키워드 또는 태그입니다. 키워드 배열도 허용됩니다. 예를 들어 ["feature, biography"] 는 콘텐츠를 설명하는 키워드 배열일 수 있습니다.
releasedEvent PublicationEvent, FeaturedEvent 또는 ExclusiveEvent 적극 권장됨 이유 - PublicationEvent는 영화의 원래 극장 개봉일과 같이 게시자가 콘텐츠의 원래 (전 세계 또는 지역) 발표를 지정하는 데 사용됩니다.

또한 FeaturedEvent를 사용하여 서비스에서 이 콘텐츠를 오리지널, 추천, 스페셜 등으로 마케팅하고 있음을 나타냅니다.

ExclusiveEvent는 서비스에 배타적인 배급 권리가 있음을 지정하고 배급 지역과 시기를 포함합니다.

자세한 내용과 예시는 예시 섹션을 참고하세요.
releasedEvent.@type 텍스트 필수 - 이 속성은 항상 다음 중 하나로 설정해야 합니다.
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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 성인용 콘텐츠의 경우 필수사항이며, 그렇지 않은 경우 권장사항입니다. 이유 - 전체 콘텐츠 등급 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 다음 두 가지 변형이 허용됩니다.
  • 평가 기관에서 평점에 공백을 넣고 접두어를 추가했습니다. 예를 들어 미국의 'MPAA' 기관에서 부여한 'PG-13' 등급은 'MPAA PG-13'으로 설명해야 합니다. 기관 목록을 참고하세요.
  • 영화의 등급을 알 수 없음을 나타내는 'RATING NOT KNOWN' 값(대소문자 구분 안 함)
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를 다음 중 하나로 설정합니다.
  • Home Release: 홈 시청을 위해 판매되거나 대여되는 버전입니다.
  • Theatrical Release: 극장에서 개봉된 버전입니다.
  • International Release: 전 세계에 출시하기 위해 수정된 버전입니다.
  • Remastered: 이미지, 사운드 또는 둘 다 최신 표준으로 개선된 버전입니다.
  • Unrated: MPAA 또는 유사한 기관에서 심사를 받지 않은 버전입니다.
  • Director Cut: 감독이 직접 승인한 편집본을 나타내는 버전입니다.
  • Extended Cut: 극장 개봉판보다 긴 버전입니다.
workExample 영화 필름의 변형을 지정합니다. 이 속성은 변형 버전의 Movie 항목이 아닌 기본 Movie 항목에 포함합니다.
workExample.@id URL Movie 변형의 경우 이 속성은 이 변형의 Movie 항목의 @id를 제공합니다.
workExample.@type 텍스트 필수 - 항상 Movie로 설정합니다. 이는 여러 대안이 있는 Movie의 배열로 표현할 수 있습니다.
workExample.@id URL 필수 - Movie 변형의 @id입니다.
workExample.name 텍스트 필수 - Movie 변형의 이름입니다.
workExample.category 텍스트 필수 - 특정 버전의 필름 변형 유형입니다. 카테고리를 다음 중 하나로 설정합니다.
  • Home Release: 홈 시청을 위해 판매되거나 대여되는 버전입니다.
  • Theatrical Release: 극장에서 개봉된 버전입니다.
  • International Release: 전 세계에 출시하기 위해 수정된 버전입니다.
  • Remastered: 이미지, 사운드 또는 둘 다 최신 표준으로 개선된 버전입니다.
  • Unrated: MPAA 또는 유사한 기관에서 심사를 받지 않은 버전입니다.
  • Director Cut: 감독이 직접 승인한 편집본을 나타내는 버전입니다.
  • Extended Cut: 극장 개봉판보다 긴 버전입니다.

예

기본 영화

확장판 버전이 있는 영화입니다.

{
  "@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"
}

이러한 속성과 관련된 주제는 다음 페이지를 참고하세요.