このセクションでは、TVSeries、TVEpisode、TVSeason エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。
TVSeason を完全なエンティティとして指定することは省略可能です。詳細については、TVSeries、TVSeason、TVEpisode の関係をご覧ください。
仕様表
TVSeries
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}]
|
@type |
テキスト | 必須 - 常に TVSeries に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。@id は次の要件を満たす必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、「識別子」セクションをご覧ください。 |
url |
URL | 必須 - Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - 番組の名前。
|
titleEIDR |
テキスト | 強く推奨 理由- 映画やテレビの作品を最も一般的な抽象レベルで表す EIDR(Entertainment Identifier Registry)識別子。 たとえば、「ゲーム オブ スローンズ」というテレビシリーズの titleEIDR は「10.5240/C1B5-3BA1-8991-A571-8472-W」です。 |
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 |
テキスト | 強く推奨 理由番組のあらすじ。プロットのあらすじは、事実の要約よりも優先されます。全角 150(半角 300)文字まで。
|
actor |
Person、PerformingGroup、PerformanceRole | 強く推奨 理由シリーズの出演者の配列。モデリングのガイダンスについては、こちらをご覧ください。 |
director |
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。複数の識別子を使用できます。詳細については、「識別子プロパティ」セクションをご覧ください。 |
popularityScore |
PopularityScoreSpecification | 強く推奨 理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。 |
popularityScore.@type |
テキスト | 常に PopularityScoreSpecification に設定。 |
popularityScore.value |
数値 | エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。 |
popularityScore.eligibleRegion |
国 | この人気度スコアを適用可能な地域。人気度スコアがグローバルに適用可能な場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。Note: ロケール固有の人気度は、グローバル(EARTH)人気度より優先されます |
review |
復習 | テレビ シリーズの評価を確認する |
review.reviewRating |
評価 | review が指定されている場合は必須。レビューで付けられた評価を指定するために使用されます。 |
contentRating |
Text または Rating | アダルト コンテンツの場合は必須、それ以外の場合は強く推奨 - 全体的なコンテンツ格付け。コンテンツのレーティングがテキスト文字列の形式で提供された場合は、次の 2 つのバリエーションが認められます。
|
contentRating.author |
組織 | contentRating で Rating が使用されている場合は必須 - 格付け機関の名前。承認されているレーティング機関の一覧については、コンテンツのレーティング機関のページをご覧ください。 |
contentRating.ratingValue |
テキスト | contentRating で Rating が使用されている場合は必須 - 格付けの値。 |
contentRating.advisoryCode |
テキスト | コンテンツの推奨コード。指定できる値は D、FV、L、S、V です。D = Dialogue(会話)、FV = Fantasy Violence(ファンタジーの暴力)、L = Language(言葉遣い)、S = Sexual Content(性的なコンテンツ)、V = Violence(暴力)。 |
TVEpisode
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}]
|
@type |
テキスト | 必須 - 常に TVEpisode に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。@id は次の要件を満たす必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、「識別子」セクションをご覧ください。 |
url |
URL | 必須 - Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - エピソードの名前。
|
titleEIDR |
テキスト | 強く推奨 理由- 映画やテレビの作品を最も一般的な抽象レベルで表す EIDR(Entertainment Identifier Registry)識別子。 たとえば、「ゲーム・オブ・スローンズ」という TVSeries の第 1 シーズンの第 1 話の titleEIDR は「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」です。 |
editEIDR |
テキスト | 強く推奨 理由- 映画やテレビ番組の特定の編集 / 版を表す EIDR(Entertainment Identifier Registry)識別子。 たとえば、「ゲーム・オブ・スローンズ」というタイトルの EIDR が「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」である TVSeries のファースト シーズンの第 1 話には、「10.5240/FB97-C847-2969-D0AB-ECD1-C」などの編集が 1 つあります。editEIDR が指定されている場合、 titleEIDR プロパティは必須です。 |
inLanguage |
テキスト | 強く推奨 - エピソードの元の言語(BCP 47 形式)。 |
episodeNumber |
整数 | 必須 - このエピソードがシーズン内の順序で何番目かを示す数値。episodeNumber はシーズンごとに開始する必要があります。つまり、各シーズンの最初のエピソードは必ず「1」になります。 |
partOfSeason |
TVSeason | 必須 - このエピソードが属している TV シーズン。TVEpisode に対応する TVSeason が存在しない場合でも、partOfSeason.@id プロパティと partOfSeason.seasonNumber プロパティを指定する必要があります。回避策は次のとおりです。
|
partOfSeason.@type |
テキスト | 必須 - 常に TVSeason に設定します。 |
partOfSeason.@id |
URL | 必須 - このエピソードが属する TVSeason の @id。 |
partOfSeason.seasonNumber |
整数 | 必須 - このシーズンが TV シリーズ内の順序で何番目かを示す数値。 |
partOfSeries |
TVSeries | 必須 - このエピソードが属している TV シリーズ。 |
partOfSeries.@type |
テキスト | 必須 - 常に TVSeries に設定します。 |
partOfSeries.@id |
URL | 必須 - このエピソードが属する TVSeries の @id。 |
partOfSeries.name |
テキスト | 必須 - TV シリーズの名前。 |
partOfSeries.sameAs |
テキスト | 番組を識別できる参照ウェブページの URL。たとえば、番組の Wikipedia ページなど。これは url プロパティとは異なる値にする必要があります。 |
potentialAction |
WatchAction | 必須(該当する場合)- アクションの詳細を提供するアクション マークアップ オブジェクト。
|
sameAs |
強く推奨 理由URL | エピソードを識別できる参照ウェブページの URL。たとえば、エピソードの Wikipedia ページなど。これは url プロパティとは異なる値にする必要があります。 |
duration |
期間 | エピソードの再生時間(ISO 8601 形式)。「PT00H00M」という形式を使用してください。 |
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 |
テキスト | 強く推奨 理由エピソードのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。全角 150(半角 300)文字まで。
|
genre |
テキスト | 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"] |
keywords |
テキスト | このコンテンツの説明に使用されるキーワードまたはタグ。キーワードの配列も使用できます。たとえば、["feature, biography"] は、コンテンツを説明するキーワードの配列です。 |
actor |
Person、PerformingGroup、PerformanceRole | 強く推奨 理由エピソードの出演者の配列。モデリングのガイダンスについては、こちらをご覧ください。 |
director |
Person | 強く推奨 理由エピソードの監督。 |
producer |
Organization または Person | 強く推奨 理由シーズンのプロデューサー。 |
image |
ImageObject | Google TV で強く推奨 理由 - TVEpisode に関連するさまざまな画像。image に含める必須プロパティと省略可能なプロパティの詳細については、画像プロパティをご覧ください。 |
trailer.description |
テキスト | 予告編の説明。予告編の例をご覧ください。 |
trailer.inLanguage |
テキスト | 強く推奨 - 予告編の言語(BCP 47 形式)。 |
trailer.url |
URL | 一般公開されている予告編の URL。各映画の制作スタジオ、または認定された配信元によってアップロードされたものです。 |
trailer.regionsAllowed |
Place | メディアが許可されている地域。指定しない場合は、すべての場所で許可されていると見なされます。ISO 3166 形式の国を指定します。 |
review |
復習 | テレビ番組のエピソードの評価を確認する |
review.reviewRating |
評価 | review が指定されている場合は必須。レビューで付けられた評価を指定するために使用されます。 |
contentRating |
Text または Rating | アダルト コンテンツの場合は必須、それ以外の場合は強く推奨 - 全体的なコンテンツ格付け。コンテンツのレーティングがテキスト文字列の形式で提供された場合は、次の 2 つのバリエーションが認められます。
|
contentRating.author |
組織 | contentRating で Rating が使用されている場合は必須 - 格付け機関の名前。承認されているレーティング機関の一覧については、コンテンツのレーティング機関のページをご覧ください。 |
contentRating.ratingValue |
テキスト | contentRating で Rating が使用されている場合は必須 - 格付けの値。 |
contentRating.advisoryCode |
テキスト | コンテンツの推奨コード。指定できる値は D、FV、L、S、V です。D = Dialogue(会話)、FV = Fantasy Violence(ファンタジーの暴力)、L = Language(言葉遣い)、S = Sexual Content(性的なコンテンツ)、V = Violence(暴力)。 |
identifier |
PropertyValue | 強く推奨 理由- このエンティティを一義的に示す外部 ID またはその他の ID。複数の識別子を使用できます。詳細については、「識別子プロパティ」セクションをご覧ください。 |
popularityScore |
PopularityScoreSpecification | 強く推奨 理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。 |
popularityScore.@type |
テキスト | 常に PopularityScoreSpecification に設定。 |
popularityScore.value |
数値 | エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。 |
popularityScore.eligibleRegion |
国 | この人気度スコアを適用可能な地域。人気度スコアがグローバルに適用可能な場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。Note: ロケール固有の人気度は、グローバル(EARTH)人気度より優先されます |
TVSeason
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}]
|
@type |
テキスト | 必須 - 常に TVSeason に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。@id は次の要件を満たす必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、「識別子」セクションをご覧ください。 |
url |
URL | 必須 - Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - この TV シーズンの名前。
|
titleEIDR |
テキスト | 強く推奨 理由- 映画やテレビの作品を最も一般的な抽象レベルで表す EIDR(Entertainment Identifier Registry)識別子。 たとえば、「ゲーム・オブ・スローンズ」として知られるテレビシリーズの最初のシーズンの titleEIDR は「10.5240/FD91-C72C-4161-FCBA-058B-1」です。 |
seasonNumber |
整数 | 必須 - このシーズンが TV シリーズ内の順序で何番目かを示す数値。 |
partOfSeries |
TVSeries | 必須 - このシーズンが属している TV シリーズ。 |
partOfSeries.@type |
テキスト | 必須 - 常に TVSeries に設定します。 |
partOfSeries.@id |
URL | 必須 - このシーズンが属する TVSeries の @id。 |
partOfSeries.name |
テキスト | 必須 - TV シリーズの名前。 |
partOfSeries.sameAs |
テキスト | 番組を識別できる参照ウェブページの URL。たとえば、番組の Wikipedia ページなど。これは url プロパティとは異なる値にする必要があります。 |
potentialAction |
WatchAction | 必須(該当する場合)- アクションの詳細を提供するアクション マークアップ オブジェクト。
|
sameAs |
URL | 強く推奨 理由シーズンを識別できる参照ウェブページの URL。たとえば、シーズンの Wikipedia ページなど。これは url プロパティとは異なる値にする必要があります。 |
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 |
テキスト | 強く推奨 理由シーズンのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。全角 150(半角 300)文字まで。
|
actor |
[Person または PerformingGroup または PerformanceRole | 強く推奨 理由シーズンの出演者の配列。モデリングのガイダンスについては、こちらをご覧ください。 |
director |
Person | 強く推奨 理由番組の監督の配列。 |
producer |
Organization または Person | 強く推奨 理由シーズンのプロデューサー。 |
image |
ImageObject | TVSeason に関連する画像。image に含める必須プロパティと省略可能なプロパティの詳細については、画像プロパティをご覧ください。 |
genre |
テキスト | 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"] |
keywords |
テキスト | このコンテンツの説明に使用されるキーワードまたはタグ。キーワードの配列も使用できます。たとえば、["feature, biography"] は、コンテンツを説明するキーワードの配列です。 |
trailer.description |
テキスト | 予告編の説明。予告編の例をご覧ください。 |
trailer.inLanguage |
テキスト | 強く推奨 - 予告編の言語(BCP 47 形式)。 |
trailer.url |
URL | 一般公開されている予告編の URL。各映画の制作スタジオ、または認定された配信元によってアップロードされたものです。 |
trailer.regionsAllowed |
Place | メディアが許可されている地域。指定しない場合は、すべての場所で許可されていると見なされます。国名を ISO 3166 形式で指定します。 |
identifier |
PropertyValue | 強く推奨 理由- このエンティティを一義的に示す外部 ID またはその他の ID。複数の識別子を使用できます。詳細については、「識別子プロパティ」セクションをご覧ください。 |
popularityScore |
PopularityScoreSpecification | 強く推奨 理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。 |
popularityScore.@type |
テキスト | 常に PopularityScoreSpecification に設定。 |
popularityScore.value |
数値 | エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。 |
popularityScore.eligibleRegion |
国 | この人気度スコアを適用可能な地域。人気度スコアがグローバルに適用可能な場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。Note: ロケール固有の人気度は、グローバル(EARTH)人気度より優先されます |
review |
復習 | テレビ シーズンの評価を確認する |
review.reviewRating |
評価 | review が指定されている場合は必須。レビューで付けられた評価を指定するために使用されます。 |
contentRating |
Text または Rating | アダルト コンテンツの場合は必須、それ以外の場合は強く推奨 - 全体的なコンテンツ格付け。コンテンツのレーティングがテキスト文字列の形式で提供された場合は、次の 2 つのバリエーションが認められます。
|
contentRating.author |
組織 | contentRating で Rating が使用されている場合は必須 - 格付け機関の名前。承認されているレーティング機関の一覧については、コンテンツのレーティング機関のページをご覧ください。 |
contentRating.ratingValue |
テキスト | contentRating で Rating が使用されている場合は必須 - 格付けの値。 |
contentRating.advisoryCode |
テキスト | コンテンツの推奨コード。指定できる値は D、FV、L、S、V です。D = Dialogue(会話)、FV = Fantasy Violence(ファンタジーの暴力)、L = Language(言葉遣い)、S = Sexual Content(性的なコンテンツ)、V = Violence(暴力)。 |
アクターの仕様
TVSeries、TVEpisode、TVSeason のエンティティ タイプの actor プロパティを使用すると、俳優の役名やテレビ番組での役柄など、俳優に関する詳細情報を指定できます。以降のセクションでは、同じ内容を説明し、使用方法を明確にするための例をいくつか示します。
| プロパティ | タイプ | 説明 |
|---|---|---|
actor |
Person、PerformingGroup、PerformanceRole | 強く推奨 理由: 出演者の配列。
複数の Person、PerformingGroup、PerformanceRole を表すには、配列を使用します。 |
Person 型または PerformingGroup 型を使用する
Person タイプまたは PerformingGroup タイプを使用する場合は、次のプロパティを指定します
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
Person または PerformingGroup | 必須 - 常に Person または PerformingGroup に設定します。 |
@id |
URL | 強く推奨 理由 - URI 形式の俳優または演奏グループの識別子。たとえば、https://example.com/actor/abc です。@id は、次の要件を満たしている必要があります。
アクター プロパティで使用される |
name |
テキスト | 必須 - 俳優/女優/出演者/パフォーマンス グループの名前。 |
sameAs |
URL | 強く推奨 理由- 俳優または演奏グループを識別できる参照ウェブページの URL。たとえば、俳優の Wikipedia ページなど。これは @id プロパティとは異なる値にする必要があります。 |
PerformanceRole 型の使用
PerformanceRole タイプを使用する場合は、次のプロパティを指定します。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
PerformanceRole | 必須 - 常に PerformanceRole に設定します。 |
roleName |
テキスト | 強く推奨 理由 - 出演者が演じた役柄。使用できる値のリストについては、こちらをご覧ください。 |
characterName |
テキスト | 演技やパフォーマンスの役割で演じるキャラクターの名前。アクターのタイプが PerformingGroup の場合は、このフィールドを設定しないでください。 |
actor |
Person または PerformingGroup | 必須 -
|
actor.@type |
Person または PerformingGroup | 必須 - 常に Person または PerformingGroup に設定します。 |
actor.@id |
URL | 強く推奨 理由 - URI 形式の俳優または演奏グループの識別子。例: https://example.com/actor/abc。@id は、次の要件を満たしている必要があります。
アクター プロパティで使用される |
actor.name |
テキスト | 必須 - 俳優/女優/出演者/パフォーマンス グループの名前。 |
actor.sameAs |
URL | 強く推奨 理由 - 俳優または演奏グループを識別できる参照ウェブページの URL。たとえば、俳優の Wikipedia ページなど。これは actor.@id プロパティとは異なる値にする必要があります。 |
使用できるロール名
これらの値では、actor.@type が Person である必要があります。
roleName 値 |
説明 |
|---|---|
| 「カメオ」 | カメオ出演とは、著名人が演劇作品に短時間出演することです。 |
| "VoiceActor" | 声の出演とは、俳優の声は使用されるが、俳優が画面に登場しないものを指します。これはアニメーションで最もよく見られますが、俳優のセリフに別の俳優のセリフが吹き替えられている場合にも発生します。 |
| 「Double」 | ダブルとは、顔が映らないように他の俳優の代役を務める人物のことです。 |
| "MotionCaptureActor" | MotionCaptureActor は、人間の俳優の動作を記録し、その情報を使用して 2D または 3D のコンピュータ アニメーションでデジタル キャラクター モデルをアニメーション化する人物を指します。 |
これらの値は通常、Person 型と PerformingGroup 型で受け入れられます。
roleName 値 |
説明 |
|---|---|
| 「アクター」 | 俳優とは、演劇という伝統的なメディアや、映画、ラジオ、テレビなどの現代的なメディアで、役を演じる人のことです。 |
| "GuestStar" | 「ゲスト スターとは、架空の役を演じ、1 つまたは数話に登場する俳優のことです。ゲスト スターが重要なリカーリング キャラクターを演じ、メインキャストのメンバーではないにもかかわらず、シリーズに何度も登場することもあります。キャストがゲスト出演している場合や、番組にゲストとして出演している場合は、値を「GuestStar」に設定します。ゲスト出演者はエピソード単位でのみ指定し、TVSeries 単位では追加しないでください。 |
| 「ゲスト」 | 「トークショーのゲスト。「GuestStar」は架空の役ですが、「Guest」は架空ではない出演です。 |
| 「アナウンサー」 | アナウンサーは、番組のオープニングとエンディングの口上を述べ、司会者、出場者、ゲストを紹介し、賞品について説明し、収録前に観客を盛り上げ、休憩中も観客を楽しませる役割を担います。 |
| 「Commentator」 | 解説者は、通常はライブ放送中に、ゲームやイベントのリアルタイム解説を行います。 |
| 「印象派」 | インプレッショニストまたはミミックとは、有名人やアニメ キャラクターの音、声、しぐさを真似るパフォーマンスを行うパフォーマーのことです。 |
| 「ホスト」 | テレビ番組を紹介、プレゼンテーション、ホストする人。多くの場合、番組と視聴者の仲介役を務めます。「ホスト」は通常、ノンフィクションの役割です。 |
| "CoHost" | 他のユーザーと共同でイベントやプログラムを主催するユーザー。 |
| 「GuestHost」 | ゲストホストとは、通常はトークショーのホストを務める人物が、通常のホストが不在の場合に代わって番組のホストを務めることです。 |
| 「ニュースキャスター」 | テレビのニュース番組を通じて、地域、国内、国際的な規模で起こっているニュースやイベントについて一般の人々に伝え、知らせる人。 |
| 「Correspondent」 | 通常、特派員や現場レポーターは、雑誌のジャーナリストやコメンテーター、新聞、ラジオ、テレビのニュース、または別の種類の会社に遠隔地からレポートを寄稿するエージェントです。 |
| "ShowJudge" | 審査員は、番組の分野の専門家とみなされることが多く、テレビ シリーズのオーディションを受けてコンテストに参加する出場者を批評する「審査員」の役割を与えられます。 |
| 「パネリスト」 | ラジオまたはテレビのパネルのディスカッション パネルまたは諮問パネルのメンバー。 |
| 「参加者」 | コンテストやゲーム番組の参加者は、それらに参加する人です。 |
| "StoryNarrator" | ナレーターは、何かを語る人、特に小説や物語詩の出来事を語るキャラクター |
| "MusicalArtist" | 「音楽アーティストは、通常、定期的に観客の前で演奏したり、音楽トラックや音楽アルバムを録音したりした個人、グループ、架空のキャラクターです。作曲者と作詞者は、一部の音楽作品のクレジットでメイン パフォーマーとしても貢献していることが示されている場合にのみ、このタイプを使用する必要があります。このタイプを使用すると、常設のミュージシャンまたはミュージシャン グループと、ゲストのミュージシャンまたはミュージシャン グループを番組に関連付けることができます。 |
俳優の主役と助演を区別する
テレビ番組のメインキャストとゲストキャストを区別するには、メインキャストは TVSeries エンティティにのみ追加し、ゲストキャストまたはサポート ロールのキャストは TVEpisode エンティティにのみ追加します。メインキャスト/レギュラーキャストが TVEpisode エンティティに追加されていないことを確認します。
例
TVSeries、TVEpisode、TVSeason の例
TVSeries
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tv_show/",
"url": "http://www.example.com/my_favorite_tv_show/",
"name": "My Favorite TV Show",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?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",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"availabilityStarts": "2017-07-21T10:35:29Z",
"availabilityEnds": "2018-10-21T10:35:29Z",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.1,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite TV show.",
"contentRating": "RATING NOT KNOWN",
"actor": [
{
"@type": "Person",
"@id": "http://www.example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "Person",
"@id": "http://www.example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0903747"
}
]
}
TVEpisode
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "TVEpisode",
"@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
"url": "http://www.example.com/my_favorite_tv_show/s7/e14",
"name": "John Doe returns with a horse.",
"episodeNumber": 14,
"contentRating": "TVPG TV-MA",
"partOfSeason": {
"@type": "TVSeason",
"@id": "http://www.example.com/my_favorite_tv_show/s7",
"seasonNumber": 7
},
"partOfSeries": {
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tv_show",
"name": "My Favorite TV Show",
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
},
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/IOSPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"availabilityStarts": "2017-07-21T10:35:29Z",
"availabilityEnds": "2018-10-21T10:35:29Z",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
"duration": "PT00H25M",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2014-01-09",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 3.9,
"eligibleRegion": "EARTH"
},
"description": "John Doe returns to the village three years after his disappearance.",
"actor": [
{
"@type": "Person",
"@id": "http://www.example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "Person",
"@id": "http://www.example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
],
"identifier": {
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt3453320"
}
}
TVSeason
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "TVSeason",
"@id": "http://www.example.com/my_favorite_tv_show/s7",
"url": "http://www.example.com/my_favorite_tv_show/s7",
"name": "Season 7",
"seasonNumber": 7,
"partOfSeries": {
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tv_show",
"name": "My Favorite TV Show",
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
},
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/IOSPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"availabilityStarts": "2017-07-21T10:35:29Z",
"availabilityEnds": "2018-10-21T10:35:29Z",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2010-09-23",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "The seventh season of My Favorite TV Show.",
"actor": [
{
"@type": "Person",
"@id": "http://www.example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "Person",
"@id": "http://www.example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
]
}
Actor プロパティの例
アクターのロールが不明
アクターの役割が不明な場合は、Person または PerformingGroup タイプを使用してアクター情報のみを提供することをおすすめします。
"actor": [
{
"@type": "Person",
"@id": "https://example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "PerformingGroup",
"@id": "https://example.com/artists/ramones",
"name": "Ramones",
"sameAs": "https://en.wikipedia.org/wiki/Ramones"
}
]
アクターのロールがわかっている
アクターの役割がわかっている場合は、PerformanceRole タイプを使用してアクター情報を提供することをおすすめします。
"actor": [
{
"@type": "PerformanceRole",
"roleName": "GuestStar",
"characterName": "Dr. Peter Venkman",
"actor": {
"@type": "Person",
"@id": "https://example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
}
},
{
"@type": "PerformanceRole",
"roleName": "Host",
"actor": {
"@type": "Person",
"@id": "https://example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
}
]
アクターのサブセットの既知のロール
パフォーマンス ロールのメタデータが不明な場合は、 Person タイプまたは PerformingGroup タイプを使用してアクター情報を提供することをおすすめします。この情報がわかっている場合は、 PerformanceRole タイプを使用します。これらのタイプは同じ配列にまとめて追加できます。
"actor": [
{
"@type": "PerformanceRole",
"roleName": "Host",
"actor": {
"@type": "Person",
"@id": "https://example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
}
},
{
"@type": "Person",
"@id": "https://example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
},
{
"@type": "PerformingGroup",
"@id": "https://example.com/artists/ramones",
"name": "Ramones",
"sameAs": "https://en.wikipedia.org/wiki/Ramones"
}
]
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。