ここでは、Movie
エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。
仕様表
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定
|
@type |
テキスト | 必須 - ムービーの場合、常に Movie に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。例: https://example.com/1234abc@id は、次の要件を満たしている必要があります。
url は識別子としてすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳しくは、識別子のセクションをご覧ください。 |
url |
URL | 必須 - コンテンツの正規 URL。Google はこの URL を使用して、フィード内のコンテンツを Google のデータベースのコンテンツと照合します。url 次の要件を満たす必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - 映画の名前。
|
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 | 必須(省略可) - アクションの詳細を提供するアクション マークアップ オブジェクト。
|
sameAs |
URL | 強く推奨理由映画を識別できる参照ウェブページの URL。たとえば、その映画について説明する Wikipedia ページなど。url プロパティとは異なる値を指定してください。 |
inLanguage |
テキスト | 映画のオリジナル言語を BCP 47 形式で表したものです。 |
genre |
テキスト | 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"] |
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 文字(全角 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 つのバリエーションを使用できます。
|
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 |
Number | エンティティの人気度を示す 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"
}
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。