このセクションでは、Movie エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。
仕様表
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}]に設定します。
|
@type |
テキスト | 必須 - 映画の場合は常に Movie に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。（例: https://example.com/1234abc）。@id は次の要件を満たしている必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
url |
URL | 必須 - Google がフィード内のコンテンツと Google のデータベース内のコンテンツを照合するために使用するコンテンツの正規 URL。url は次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - 映画の名前。
|
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 | 必須（該当する場合） - アクションの詳細を提供するアクション マークアップ オブジェクト。
|
sameAs |
URL | 強く推奨理由映画を識別できる参照ウェブページの URL。たとえば、その映画について説明する Wikipedia ページなど。url プロパティとは異なる値を指定する必要があります。 |
inLanguage |
テキスト | 映画の元の言語（BCP 47 形式）。 |
genre |
テキスト | 関連するすべてのジャンルの順序付きリスト。例 : ["アクション", "ファッション", "環境", "サッカー"] |
keywords |
テキスト | このコンテンツを説明するために使用されるキーワードまたはタグ。キーワードの配列も使用できます。たとえば、["feature, biography"] は、コンテンツを説明するキーワードの配列になります。 |
releasedEvent |
PublicationEvent、FeaturedEvent、または ExclusiveEvent |
強く推奨理由- PublicationEvent は、映画の初公開日など、パブリッシャーによるコンテンツのオリジナル（全世界またはローカル）の公開日を指定するために使用します。また、 FeaturedEvent を使用して、サービスがオリジナル、注目のコンテンツ、スペシャル コンテンツなどとしてこのコンテンツを提供することを示します。ExclusiveEvent は、サービスが独占的配信権を持つことと、場所と時期を含むことを指定します。詳細と例については、サンプル セクションをご覧ください。 |
releasedEvent.@type |
テキスト | 必須 - このプロパティは必ず次のいずれかに設定します。
|
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 |
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 つのバリエーションを使用できます。
|
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 |
番号 | エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。 |
popularityScore.eligibleRegion |
国 | この人気度スコアを適用可能な地域。人気スコアがグローバルに適用できる場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。Note: 言語 / 地域固有の人気度はグローバル（EARTH）の人気度よりも優先されます |
category |
テキスト | 必須（該当する場合） - エンティティが Movie バリアントの場合は、このプロパティを設定します。category を次のいずれかに設定します。
|
workExample |
映画 | 映画のバリエーションを指定します。このプロパティは、バリアント バージョンの Movie エンティティではなく、メインの Movie エンティティに含めます。 |
workExample.@id |
URL | Movie バリアントの場合、このプロパティはバリアントである Movie エンティティの @id を提供します。 |
workExample.@type |
テキスト | 必須 - 常に Movie に設定します。これは、複数のバリアントを持つ Movie の配列として表すことができます。 |
workExample.@id |
URL | 必須 - Movie バリアントの @id。 |
workExample.name |
テキスト | 必須 - Movie バリアントの名前。 |
workExample.category |
テキスト | 必須 - 特定のバージョンの映画バリエーションのタイプ。カテゴリを次のいずれかに設定します。
|
例
メインムービー
拡張カットのバリエーションを含む映画。
{
"@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"
}
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。