영화의 콘텐츠 마크업 속성

이 섹션에서는 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 필수 - 콘텐츠의 표준 URL입니다. Google은 이 URL을 사용하여 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 일치시킵니다.
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) 식별자입니다.

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

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

ExclusiveEvent는 서비스에 독점 배포권이 있으며 위치와 시간을 포함함을 지정합니다.

자세한 내용과 예시는 예시 섹션을 참고하세요.
releasedEvent.@type 텍스트 필수 - 항상 이 속성을 다음 중 하나로 설정해야 합니다.
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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 텍스트 또는 평점 성인용 콘텐츠의 경우 필수이며, 그 외의 경우 매우 권장하는 이유 - 전반적인 콘텐츠 등급입니다. 콘텐츠 등급이 텍스트 문자열 형식으로 제공되는 경우 두 가지 변형이 허용됩니다.
  • 등급 기관이 등급 앞에 공백을 두고 추가됩니다. 예를 들어 미국의 '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 필수 - @id 옵션의 Movie입니다.
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"
}

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