このセクションでは、Movie エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。
仕様表
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http:/に設定します。
|
@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）ID。 たとえば、「ゴーストバスターズ」という映画の titleEIDR は「10.5240/7EC7-228A-510A-053E-CBB8-J」です。 |
editEIDR |
テキスト | 強く推奨理由- 映画またはテレビ作品の特定の編集 / エディションを表す EIDR（Entertainment Identifier Registry）ID。 たとえば、「Ghostbusters」という映画のタイトル 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 | 該当する場合は必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。
|
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"
}
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。