영화의 콘텐츠 마크업 속성

이 섹션에서는 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이 포함되어야 합니다.
재생의 딥 링크는 target 객체의 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 마크업 객체
  • VOD로 콘텐츠를 사용할 수 있는 경우 이 속성은 필수입니다. 작업 마크업 객체는 콘텐츠의 딥 링크를 제공해야 합니다.
  • LiveTV 채널에서 콘텐츠를 사용할 수 있는 경우 이 속성은 선택사항입니다. 연결된 BroadcastService 항목이 채널의 딥 링크를 대신 제공합니다.
  • Movie는 VoD와 LiveTV에서 모두 사용할 수 있습니다.
배열을 사용하여 여러 지역에 서로 다른 딥 링크를 지정합니다. 여러 지역 및 언어 예를 참고하세요.
sameAs URL 강력 추천 이유 영화를 식별할 수 있는 참조 웹페이지의 URL 영화의 위키백과 페이지를 예로 들 수 있습니다. 이는 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 예를 참고하세요.
trailer.inLanguage 텍스트 BCP 47 형식의 트레일러 언어입니다.
trailer.url URL 각 프로덕션 스튜디오 또는 공인 소스에서 공개적으로 호스팅되고 업로드된 트레일러의 URL입니다.
trailer.regionsAllowed 장소 미디어가 허용되는 지역입니다. 지정하지 않으면 모든 국가에서 허용되는 것으로 간주됩니다. ISO 3166 형식으로 국가를 지정합니다.
identifier PropertyValue 강력 추천 이유 - 이 항목을 명확하게 식별하는 외부 ID 또는 기타 ID입니다. 여러 식별자를 사용할 수 있습니다. 자세한 내용은 식별자 속성 섹션을 참조하세요.
review 리뷰 영화 리뷰 평점
review.reviewRating 평점 검토가 제공되는 경우 필수 항목입니다. 리뷰에 부여된 평점을 지정하는 데 사용됩니다.
contentRating Text 또는 Rating 성인용 콘텐츠의 경우 필수사항이며 다른 경우에는 적극 권장됩니다. 이유 - 전체 콘텐츠 등급. 콘텐츠 등급이 텍스트 문자열 형식으로 주어진 경우 두 가지 변형이 허용됩니다.
  • 등급 부여 기관이 등급 앞에 공백을 두었습니다. 예를 들어 'PG-13'입니다. 대행사 'MPAA' 등급 'MPAA PG-13'으로 설명되어야 합니다. 대행사 목록을 참고하세요.
  • '등급 알 수 없음' 값 (대소문자를 구분하지 않음)를 사용하여 영화의 등급을 모를 수 있습니다.
contentRating.author 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를 다음 중 하나로 설정합니다.
  • 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"
}

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