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

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

仕様表

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

たとえば、「ゴースト バスターズ」というタイトルの映画のタイトルは「10.5240/7EC7-228A-510A-053E-CBB8-J」です。
editEIDR Text 強くおすすめする理由- 映画やテレビの作品に対して特定の編集または編集を表す EIDR(Entertainment Identifier Registry)識別子。

たとえば、「ゴースト バスターズ」という名前の映画は、タイトル EIDR が「10.5240/7EC7-228A-510A-053E-CBB8-J」を中心としていて、いくつかの編集があります。

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

さらに、FeaturedEvent を使用して、そのコンテンツをオリジナル、おすすめ、特別コンテンツなどとしてマーケティングの対象に指定します。

ExclusiveEvent - サービス内で独占配信権を所有し、掲載する場所とタイミングを指定します。

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

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

FeaturedEventExclusiveEvent の場合、これは、コンテンツが掲載または限定されている地域です。

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

PublicationEvent の場合、このエンティティの最初の公開日です。たとえば、映画が映画館で初めて公開された日付になります。

ExclusiveEventFeaturedEvent の場合、エンティティが独占的または注目を集めている開始日を表します。
releasedEvent.endDate 日付 または日時 推奨 - ExclusiveEvent で必須 - ExclusiveEventFeaturedEvent タイプにのみ適用されます。

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

FeaturedEvent の場合、プロバイダがエンティティを最後に表示する日付です。

コンテンツが永続的に独占的またはを表示している場合は、endDate を 20 年後に設定します。
releasedEvent.publishedBy Organization または Person 省略可 - このエンティティを公開した組織または個人。
description Text 強くおすすめする理由映画のあらすじ。プロットのあらすじは、事実の要約よりも優先されます。300 文字が上限です。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の地域と言語の例をご覧ください。
duration 所要時間 ISO 8601 形式の映画のランタイム。次の形式を使用してください:" PT00H00M"。
director 担当者 強くおすすめする理由映画監督。
actor 担当者 強くおすすめする理由映画の出演者。
producer Organization または Person 強くおすすめする理由映画のプロデューサー。
image ImageObject Google TV について必須 - 映画に関連する画像。image に含める必須プロパティとオプションのプロパティの詳細については、画像プロパティをご覧ください。
trailer.description Text 予告編の説明。予告編の例をご覧ください。
trailer.inLanguage Text 予告編の言語(BCP 47 形式)。
trailer.url URL 制作会社や承認されたソースによって一般公開され、アップロードされた予告編の URL。
trailer.regionsAllowed Place メディアが許可されている地域。指定しない場合は、すべての場所で許可されていると見なされます。国名を ISO 3166 形式で指定します。
identifier PropertyValue 強くおすすめする理由- このエンティティを明確に識別する外部 ID またはその他の ID。複数の識別子を使用できます。詳しくは、ID プロパティ セクションをご覧ください。
review 復習 映画の評価を確認する
review.reviewRating 評価 レビューが提供される場合は必須。レビューの評価を指定します。
contentRating テキストまたは評価 アダルト コンテンツでは必須。それ以外は強く推奨します。理由- 全体的なコンテンツ レーティング。コンテンツのレーティングがテキスト形式の場合は、次の 2 つのバージョンを指定できます。
  • 評価の最初に、評価の後に空白を挿入します。たとえば、「PG-13」という評価は、米国では「MPAA PG-13」と記載する必要があります。代理店のリストをご覧ください。
  • 映画のレーティングが不明であることを示す値に「RATING NOT KNOWN&quot」(大文字と小文字は区別されない)の値。
contentRating.author テキスト または組織 contentRatingRating を使用している場合は必須 - レーティング代理店の名前。
contentRating.ratingValue Text contentRatingRating を使用している場合は必須 - 評価の値。
contentRating.advisoryCode Text コンテンツのアドバイザリ コード。有効な値は、D、FV、L、S、V です。D = 会話、FV = 空想上の暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。
popularityScore PopularityScoreSpecification 強くおすすめする理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。
popularityScore.@type Text 常に PopularityScoreSpecification に設定されます。
popularityScore.value Number エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。
popularityScore.eligibleRegion この人気度スコアを適用可能な地域。人気度スコアがグローバルに適用可能な場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。
Note: 言語 / 地域固有の人気度はグローバル(EARTH)の人気度より優先
category Text 該当する場合は必須 - エンティティが 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 Text 必須 - 常に Movie に設定されます。これは、複数のバリアントを持つ Movie の配列として表すことができます。
workExample.@id URL 必須 - Movie バリアントの @id
workExample.name Text 必須 - Movie バリアントの名前。
workExample.category Text 必須 - 特定のバージョンのフィルム バリエーションのタイプ。カテゴリを次のいずれかに設定します。
  • 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"
}

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