TV 番組のコンテンツ マークアップ プロパティ

このセクションでは、TVSeriesTVEpisodeTVSeason エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。

TVSeason を完全なエンティティとして指定することは省略可能です。詳細については、TVSeries、TVSeason、TVEpisode の関係をご覧ください。

仕様表

TVSeries

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}]
    に設定します
  • ここで、「xx」はフィード内の文字列の言語を表します。各ルート エンティティ コンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕や吹き替えの言語が英語であっても、名前はスペイン語であると想定されます。
@type テキスト 必須 - 常に TVSeries に設定します。
@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 つのみです。
titleEIDR テキスト 強く推奨 理由- 映画やテレビの作品を最も一般的な抽象レベルで表す EIDR(Entertainment Identifier Registry)識別子。

たとえば、「ゲーム オブ スローンズ」というテレビシリーズの titleEIDR は「10.5240/C1B5-3BA1-8991-A571-8472-W」です。
potentialAction WatchAction 必須(該当する場合)- アクションの詳細を提供するアクション マークアップ オブジェクト
  • コンテンツがビデオ オンデマンド(VoD)で利用できる場合は、このプロパティは必須です。アクション マークアップ オブジェクトはコンテンツのディープリンクを提供する必要があります。
  • コンテンツが LiveTV チャンネルで利用可能な場合は、このプロパティは省略できます。代わりに、関連付けられた BroadcastService エンティティがチャネルのディープリンクを提供します。
  • TVSeries は、VoD と LiveTV の両方で利用できます。
配列を使用して、複数の地域内の異なるディープリンクを指定します。複数の地域と言語の例をご覧ください。
sameAs URL 強く推奨 理由番組を識別できる参照ウェブページの URL。たとえば、番組の Wikipedia ページなど。これは url プロパティとは異なる値にする必要があります。
inLanguage テキスト 強く推奨 - シリーズの元の言語(BCP 47 形式)。
genre テキスト 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"]
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 テキスト 強く推奨 理由番組のあらすじ。プロットのあらすじは、事実の要約よりも優先されます。全角 150(半角 300)文字まで。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の地域と言語の例をご覧ください。
actor PersonPerformingGroupPerformanceRole 強く推奨 理由シリーズの出演者の配列。モデリングのガイダンスについては、こちらをご覧ください。
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 つのバリエーションが認められます。
  • 格付けの前に空白を挟んで格付け機関を付加します。たとえば、米国の代理店「TVPG」からの「TV-MA」格付けは、「TVPG TV-MA」と記述します。機関のリストをご覧ください。
  • コンテンツのレーティングが不明であることを示す値「RATING NOT KNOWN」(大文字と小文字を区別しない)。
contentRating.author 組織 contentRatingRating が使用されている場合は必須 - 格付け機関の名前。承認されているレーティング機関の一覧については、コンテンツのレーティング機関のページをご覧ください。
contentRating.ratingValue テキスト contentRatingRating が使用されている場合は必須 - 格付けの値。
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"}]
    に設定します
  • ここで、「xx」はフィード内の文字列の言語を表します。各ルート エンティティ コンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕や吹き替えの言語が英語であっても、名前はスペイン語であると想定されます。
@type テキスト 必須 - 常に TVEpisode に設定します。
@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 つのみです。
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 プロパティを指定する必要があります。回避策は次のとおりです。
  • partofSeries.@id(http://www.example.com/my_favorite_tv_show など)を取得して、プレースホルダ クエリ フィールド(?season1 など)を付加し、一意の partOfSeason.@id(http://www.example.com/my_favorite_tv_show?season1 など)を作成します。
  • partOfSeason.seasonNumber を 1 に設定する。
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 必須(該当する場合)- アクションの詳細を提供するアクション マークアップ オブジェクト
  • コンテンツがビデオ オンデマンド(VoD)で利用できる場合は、このプロパティは必須です。アクション マークアップ オブジェクトはコンテンツのディープリンクを提供する必要があります。
  • コンテンツが LiveTV チャンネルで利用可能な場合は、このプロパティは省略できます。代わりに、関連付けられた BroadcastService エンティティがチャネルのディープリンクを提供します。
  • TVEpisode は、VoD と LiveTV の両方で利用できます。
配列を使用して、複数の地域内の異なるディープリンクを指定します。複数の地域と言語の例をご覧ください。
sameAs 強く推奨 理由URL エピソードを識別できる参照ウェブページの URL。たとえば、エピソードの Wikipedia ページなど。これは url プロパティとは異なる値にする必要があります。
duration 期間 エピソードの再生時間(ISO 8601 形式)。「PT00H00M」という形式を使用してください。
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 テキスト 強く推奨 理由エピソードのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。全角 150(半角 300)文字まで。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の言語表現の例をご覧ください。
genre テキスト 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"]
keywords テキスト このコンテンツの説明に使用されるキーワードまたはタグ。キーワードの配列も使用できます。たとえば、["feature, biography"] は、コンテンツを説明するキーワードの配列です。
actor PersonPerformingGroupPerformanceRole 強く推奨 理由エピソードの出演者の配列。モデリングのガイダンスについては、こちらをご覧ください。
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 つのバリエーションが認められます。
  • 格付けの前に空白を挟んで格付け機関を付加します。たとえば、米国の代理店「TVPG」からの「TV-MA」格付けは、「TVPG TV-MA」と記述します。機関のリストをご覧ください。
  • コンテンツのレーティングが不明であることを示す値「RATING NOT KNOWN」(大文字と小文字を区別しない)。
contentRating.author 組織 contentRatingRating が使用されている場合は必須 - 格付け機関の名前。承認されているレーティング機関の一覧については、コンテンツのレーティング機関のページをご覧ください。
contentRating.ratingValue テキスト contentRatingRating が使用されている場合は必須 - 格付けの値。
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"}]
    に設定します
  • ここで、「xx」はフィード内の文字列の言語を表します。各ルート エンティティ コンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕や吹き替えの言語が英語であっても、名前はスペイン語であると想定されます。
@type テキスト 必須 - 常に TVSeason に設定します。
@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 テキスト 必須 - この TV シーズンの名前。
  • 複数の言語で名前を列挙するには、配列を使用します。複数の言語表現の例をご覧ください。
  • ロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
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 必須(該当する場合)- アクションの詳細を提供するアクション マークアップ オブジェクト
  • コンテンツがビデオ オンデマンド(VoD)で利用できる場合は、このプロパティは必須です。アクション マークアップ オブジェクトはコンテンツのディープリンクを提供する必要があります。
  • コンテンツが LiveTV チャンネルで利用可能な場合は、このプロパティは省略できます。代わりに、関連付けられた BroadcastService エンティティがチャネルのディープリンクを提供します。
  • TVSeason は、VoD と LiveTV の両方で利用できます。
配列を使用して、複数の地域内の異なるディープリンクを指定します。複数の地域と言語の例をご覧ください。
sameAs URL 強く推奨 理由シーズンを識別できる参照ウェブページの URL。たとえば、シーズンの Wikipedia ページなど。これは url プロパティとは異なる値にする必要があります。
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 テキスト 強く推奨 理由シーズンのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。全角 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 つのバリエーションが認められます。
  • 格付けの前に空白を挟んで格付け機関を付加します。たとえば、米国の代理店「TVPG」からの「TV-MA」格付けは、「TVPG TV-MA」と記述します。機関のリストをご覧ください。
  • コンテンツのレーティングが不明であることを示す値「RATING NOT KNOWN」(大文字と小文字を区別しない)。
contentRating.author 組織 contentRatingRating が使用されている場合は必須 - 格付け機関の名前。承認されているレーティング機関の一覧については、コンテンツのレーティング機関のページをご覧ください。
contentRating.ratingValue テキスト contentRatingRating が使用されている場合は必須 - 格付けの値。
contentRating.advisoryCode テキスト コンテンツの推奨コード。指定できる値は D、FV、L、S、V です。D = Dialogue(会話)、FV = Fantasy Violence(ファンタジーの暴力)、L = Language(言葉遣い)、S = Sexual Content(性的なコンテンツ)、V = Violence(暴力)。

アクターの仕様

TVSeriesTVEpisodeTVSeason のエンティティ タイプの actor プロパティを使用すると、俳優の役名やテレビ番組での役柄など、俳優に関する詳細情報を指定できます。以降のセクションでは、同じ内容を説明し、使用方法を明確にするための例をいくつか示します。

プロパティ タイプ 説明
actor PersonPerformingGroupPerformanceRole 強く推奨 理由: 出演者の配列。
  • 出演者の役柄と(必要に応じて)役名がわかっている場合は、PerformanceRole 型を使用します。この場合、アクター Person または PerformingGroupPerformanceRole オブジェクト内に埋め込まれます。
  • 出演者の役柄が不明な場合は、タイプ Person を使用して個々の俳優を示し、PerformingGroup を使用して出演グループやバンドの詳細を指定します。

複数の Person、PerformingGroup、PerformanceRole を表すには、配列を使用します。

Person 型または PerformingGroup 型を使用する

Person タイプまたは PerformingGroup タイプを使用する場合は、次のプロパティを指定します

プロパティ タイプ 説明
@type Person または PerformingGroup 必須 - 常に Person または PerformingGroup に設定します。
@id URL 強く推奨 理由 - URI 形式の俳優または演奏グループの識別子。たとえば、https://example.com/actor/abc です。@id は、次の要件を満たしている必要があります。
  • アクター/パフォーマンス グループごとにカタログ全体でグローバルに一意
  • 時間が経過しても変化しないものにする必要があります。これは不透明な文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier(URI)の形式
  • @id 値に使用するドメインは、組織が所有している必要があります。

アクター プロパティで使用される @id は、フィード全体で一貫して使用する必要があります。たとえば、同じ俳優が出演している映画が 2 つある場合、これらの 2 つの俳優オブジェクト間で @id 値を同じにする必要があります。

name テキスト 必須 - 俳優/女優/出演者/パフォーマンス グループの名前。
sameAs URL 強く推奨 理由- 俳優または演奏グループを識別できる参照ウェブページの URL。たとえば、俳優の Wikipedia ページなど。これは @id プロパティとは異なる値にする必要があります。

PerformanceRole 型の使用

PerformanceRole タイプを使用する場合は、次のプロパティを指定します。

プロパティ タイプ 説明
@type PerformanceRole 必須 - 常に PerformanceRole に設定します。
roleName テキスト 強く推奨 理由 - 出演者が演じた役柄。使用できる値のリストについては、こちらをご覧ください。
characterName テキスト 演技やパフォーマンスの役割で演じるキャラクターの名前。アクターのタイプが PerformingGroup の場合は、このフィールドを設定しないでください。
actor Person または PerformingGroup 必須 -
  • データ型 Person が使用されている場合のコンテンツのキャスト メンバー。
  • データ型 PerformingGroup が使用されている場合、コンテンツの演奏グループ。
actor.@type Person または PerformingGroup 必須 - 常に Person または PerformingGroup に設定します。
actor.@id URL 強く推奨 理由 - URI 形式の俳優または演奏グループの識別子。例: https://example.com/actor/abc。@id は、次の要件を満たしている必要があります。
  • アクター/パフォーマンス グループごとにカタログ全体でグローバルに一意
  • 時間が経過しても変化しないものにする必要があります。これは不透明な文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier(URI)の形式
  • @id 値に使用するドメインは、組織が所有している必要があります。

アクター プロパティで使用される @id は、フィード全体で一貫して使用する必要があります。たとえば、同じ俳優が出演している映画が 2 つある場合、これらの 2 つの俳優オブジェクト間で @id 値を同じにする必要があります。

actor.name テキスト 必須 - 俳優/女優/出演者/パフォーマンス グループの名前。
actor.sameAs URL 強く推奨 理由 - 俳優または演奏グループを識別できる参照ウェブページの URL。たとえば、俳優の Wikipedia ページなど。これは actor.@id プロパティとは異なる値にする必要があります。

使用できるロール名

これらの値では、actor.@typePerson である必要があります。

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 エンティティに追加されていないことを確認します。

TVSeriesTVEpisodeTVSeason の例

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"
  }
]

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