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

このセクションでは、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 必須 - Google がフィード内のコンテンツと Google のデータベース内のコンテンツを照合するために使用するコンテンツの正規 URL
url は次の要件を満たしている必要があります。
  • url はグローバルに一意である必要があります
  • url には、Google がクロールできる有効な正規 URL を含める必要があります。
再生のディープリンクについては、代わりにターゲット オブジェクトの urlTemplate プロパティをご覧ください。
name テキスト 必須 - 映画の名前。
  • 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。
  • 1 つのロケール(言語と国のペア)につき 1 つの名前のみがサポートされます。
titleEIDR テキスト 強く推奨理由- 映画やテレビの作品を最も一般的または抽象的なレベルで表す EIDR(Entertainment Identifier Registry)の識別子。

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

たとえば、「ゴーストバスターズ」と呼ばれる映画「10.5240/7EC7-228A-510A-053E-CBB8-J」というタイトルの EIDR には、次のような編集があります。"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 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 の場合は必須 - これは ExclusiveEvent タイプと FeaturedEvent タイプにのみ適用されます。

ExclusiveEvent の場合、コンテンツの権利が期限切れになる日付を示します。

FeaturedEvent の場合、プロバイダがエンティティを永久に独占的に掲載または紹介する場合は、endDate を現在の日付から 20 年に設定します。

releasedEvent.publishedBy Organization または Person 省略可 - このエンティティを公開した組織または個人。
description テキスト 強く推奨理由映画のあらすじ。プロットのあらすじは、事実の要約よりも優先されます。最大 300 文字。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の地域と言語の例をご覧ください。
duration 期間 映画の再生時間(ISO 8601 形式)。「PT00H00M」の形式を使用してください。
director Person 強く推奨理由映画監督。
actor Person 強く推奨理由映画の出演者。
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 Text または Rating アダルト コンテンツの場合は必須、それ以外の場合は強く推奨。理由- 全体的なコンテンツのレーティング。コンテンツのレーティングを文字列の形式で指定する場合は、次の 2 つのバリエーションを使用できます。
  • レーティング機関は、レーティングの先頭に空白文字を挿入します。たとえば、「PG-13」は代理店「MPAA」からの評価米国では「MPAA PG-13」と表記してください。代理店のリストをご覧ください。
  • 値が「RATING NOT KNOWN」(大文字と小文字は区別されません)は、Movie のレーティングが不明であることを示します。
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 番号 エンティティの人気度を示す 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"
}

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