映画のコンテンツ マークアップ プロパティ

ここでは、Movie エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。

仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定
  • ここで、xx はフィード内の文字列の言語を表します。各ルート エンティティのコンテキストでは、@language を BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語をスペイン語に設定すると、字幕の言語が英語であっても、名前はスペイン語とみなされます。
@type テキスト 必須 - ムービーの場合、常に Movie に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子。例: https://example.com/1234abc
@id は、次の要件を満たしている必要があります。
  • カタログ全体でグローバルに一意
  • 静的。ID は安定していて、時間の経過とともに変化してはなりません(番組の url プロパティが変更された場合でも)。これは不透明な文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier(URI)の形式
  • @id 値に使用するドメインが、自分の組織が所有するものであること。
エンティティの url は識別子としてすべての要件を満たしているため、エンティティの url@id として使用することをおすすめします。詳しくは、識別子のセクションをご覧ください。
url URL 必須 - コンテンツの正規 URL。Google はこの URL を使用して、フィード内のコンテンツを Google のデータベースのコンテンツと照合します。
url次の要件を満たす必要があります。
  • url はグローバルに一意である必要があります
  • url には、Google がクロールできる有効な正規 URL を含める必要があります。
再生のディープリンクについては、代わりに target オブジェクトの urlTemplate プロパティをご覧ください。
name テキスト 必須 - 映画の名前。
  • 複数の言語で名前を列挙するには、配列を使用します。「複数の地域と言語」の例をご覧ください。
  • 1 つのロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
titleEIDR テキスト 強く推奨理由- EIDR(Entertainment Identifier Registry)の識別子。最も一般的または抽象的なレベルで、映画やテレビの作品を表します。

たとえば、「ゴースト バスターズ」という名前の動画の titleEIDR は、「10.5240/7EC7-228A-510A-053E-CBB8-J」です。
editEIDR テキスト 強く推奨理由- 映画やテレビの作品の特定の編集内容やエディションを表す EIDR(Entertainment Identifier Registry)

たとえば、「Ghostbusters」として知られる映画で EIDR のタイトルが「10.5240/7EC7-228A-510A-053E-CBB8-J」の場合
editEIDR を指定する場合、
titleEIDR プロパティは必須です。
potentialAction WatchAction 必須(省略可) - アクションの詳細を提供するアクション マークアップ オブジェクト
  • コンテンツがビデオ オンデマンド(VoD)で利用できる場合は、このプロパティは必須です。アクション マークアップ オブジェクトはコンテンツのディープリンクを提供する必要があります。
  • コンテンツが LiveTV チャンネルで利用可能な場合、このプロパティは省略可能です。関連付けられた BroadcastService エンティティは、代わりにチャンネルのディープリンクを提供します。
  • Movie は、VoD と LiveTV の両方で利用できます。
配列を使用して、複数のリージョンの異なるディープリンクを指定します。複数の地域と言語の例をご覧ください。
sameAs URL 強く推奨理由映画を識別できる参照ウェブページの URL。たとえば、その映画について説明する Wikipedia ページなど。url プロパティとは異なる値を指定してください。
inLanguage テキスト 映画のオリジナル言語を BCP 47 形式で表したものです。
genre テキスト 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"]
keywords テキスト このコンテンツを説明するために使用されるキーワードまたはタグ。キーワードの配列も使用できます。たとえば [feature, biography] は、コンテンツを説明するキーワードの配列になります。
releasedEvent PublicationEventFeaturedEvent、または ExclusiveEvent 強く推奨理由- PublicationEvent は、出版社のオリジナル(全世界またはローカル)のリリースを指定する場合に使用します。たとえば、映画のオリジナル公開日などを指定します。

さらに、FeaturedEvent を使用して、このコンテンツがオリジナル、注目の映画、特別コンテンツなどとしてマーケティングされることを示します。

ExclusiveEvent に、このサービスが独占配信の権利と地域と時間が含まれることを指定します。

詳細と例については、サンプル セクションをご覧ください。
releasedEvent.@type テキスト 必須 - このプロパティは必ず次のいずれかに設定します。
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 必須 - このイベントに関連付けられている地域。

PublicationEvent の場合、これはコンテンツが公開された地域です。

FeaturedEventExclusiveEvent の場合、これはコンテンツを掲載する地域、または除外される地域です。

国は ISO 3166 コードを使用します。世界の任意の場所を示すには、EARTH に設定します。
releasedEvent.startDate Date または DateTime 推奨 - ExclusiveEvent の場合は必須 - エンティティの公開の開始日。

PublicationEvent の場合は、このエンティティの最初のリリース日(映画が映画館で最初に公開された日付など)を示します。

ExclusiveEventFeaturedEvent の場合は、エンティティが排他的または注目の開始日になります。
releasedEvent.endDate Date または DateTime 推奨 - ExclusiveEvent の場合は必須です - ExclusiveEventFeaturedEvent タイプにのみ適用されます。

ExclusiveEvent の場合、これはコンテンツの権利の有効期限を表します。

FeaturedEvent の場合、プロバイダがエンティティを明示した最後の日付を表します。

コンテンツが永続的に独占的または注目のコンテンツとして表示される場合は、endDate を現在の日付から 20 年に設定します。
releasedEvent.publishedBy Organization または Person 省略可 - このエンティティを公開した組織またはユーザー。
description テキスト 強く推奨理由映画のあらすじ。プロットのあらすじは、事実の要約よりも優先されます。半角 300 文字(全角 150 文字)以内。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の地域と言語の例をご覧ください。
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 Place メディアが許可されている地域。指定しない場合は、すべての場所で許可されていると見なされます。国名を ISO 3166 形式で指定します。
identifier PropertyValue 強く推奨理由- このエンティティを明確に識別する外部 ID またはその他の ID。複数の識別子を使用できます。詳しくは、識別子プロパティのセクションをご覧ください。
review 復習 映画のレーティングの確認
review.reviewRating 評価 審査が指定されている場合は必須レビューの評価を指定します。
contentRating テキストまたは評価 アダルト コンテンツでは必須、それ以外の場合は推奨- コンテンツ レーティング全体。コンテンツのレーティングがテキスト文字列で提供される場合、次の 2 つのバリエーションを使用できます。
  • 格付けの前にレーティング機関が空白文字で囲みます。たとえば、米国の代理店「MPAA」の「PG-13」レーティングは「MPAA PG-13」と記載する必要があります。代理店の一覧をご覧ください。
  • 映画の評価が不明であることを示すために、「RATING NOT KNOWN」(大文字と小文字を区別しない)の値。
contentRating.author テキストまたは組織 contentRatingRating を使用する場合は必須です - 評価機関の名前。
contentRating.ratingValue テキスト contentRatingRating を使用する場合に必須 - 評価の値。
contentRating.advisoryCode テキスト コンテンツのアドバイザリ コード。許容される値には、D、FV、L、S、V があります。D = 会話、FV = ファンタジー暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。
popularityScore PopularityScoreSpecification 強く推奨理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。
popularityScore.@type テキスト 常に PopularityScoreSpecification に設定します。
popularityScore.value Number エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。
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"
}

これらのプロパティに関連するトピックについては、次のページを確認してください。