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 つのロケール(言語と国のペア)につき 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 テキスト 強く推奨理由番組のあらすじ。プロットのあらすじは、事実の要約よりも優先されます。最大 300 文字。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の地域と言語の例をご覧ください。
actor PersonPerformingGroup、または PerformanceRole 強く推奨理由シリーズのキャスト メンバーの配列。モデリングのガイダンスについては、こちらをご覧ください。
director Person 強く推奨理由番組のディレクター。
producer Organization または Person 強く推奨理由番組のプロデューサー。
image ImageObject Google TV では必須 - TVSeries に関連する画像。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 つのバリエーションを使用できます。
  • レーティング機関は、レーティングの先頭に空白文字を挿入します。例: 「TV-MA」代理店「TVPG」の評価は「TVPG TV-MA」と記述する必要があります。代理店のリストをご覧ください。
  • 値が「RATING NOT KNOWN」(大文字と小文字を区別しない)を使用して、コンテンツの評価が不明であることを示します。
contentRating.author 組織 contentRatingRating を使用している場合は必須 - レーティング機関の名前。承認されているレーティング機関の一覧については、コンテンツ レーティング機関のページをご覧ください。
contentRating.ratingValue テキスト contentRatingRating を使用する場合は必須 - 評価の値。
contentRating.advisoryCode テキスト コンテンツのアドバイザリ コード。指定可能な値は、D、FV、L、S、V です。D = 対話、FV = ファンタジーの暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。

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 つのロケール(言語と国のペア)につき 1 つの名前のみがサポートされます。
titleEIDR テキスト 強く推奨理由- 映画やテレビの作品を最も一般的または抽象的なレベルで表す EIDR(Entertainment Identifier Registry)の識別子。

たとえば、「ゲーム・オブ・スローンズ」というテレビシリーズの最初のシーズンの最初のエピソードの場合は titleEIDR と指定します「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」です。
editEIDR テキスト 強く推奨理由- 映画またはテレビ作品の特定の編集 / エディションを表す EIDR(Entertainment Identifier Registry)の識別子。

たとえば、「ゲーム・オブ・スローンズ」というタイトルの TV シリーズ第 1 シーズンの最初のエピソード(タイトル EIDR が「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」)には、次のような編集があります。"10.5240/FB97-C847-2969-D0AB-ECD1-C".

editEIDR が指定されている場合、titleEIDR プロパティは必須です。
inLanguage テキスト シリーズの元の言語(BCP 47 形式)。
episodeNumber 整数 必須 - シーズン内におけるこのエピソードの位置を示す番号。episodeNumber はシーズンごとに再起動する必要があります。つまり、各シーズンの最初のエピソードを 1 にする必要があります。
partOfSeason TVSeason 必須 - このエピソードが属するテレビシーズン。

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 テキスト 強く推奨理由エピソードのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。最大 300 文字。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の言語表現の例をご覧ください。
genre テキスト 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"]
keywords テキスト このコンテンツを説明するために使用されるキーワードまたはタグ。キーワードの配列も使用できます。たとえば、["feature, biography"] は、コンテンツを説明するキーワードの配列になります。
actor PersonPerformingGroup、または 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 形式の国を指定します。
review 復習 テレビ番組のエピソードの評価を確認する
review.reviewRating 評価 review が指定されている場合は必須。レビューで与えられた評価を指定するために使用されます。
contentRating Text または Rating アダルト コンテンツの場合は必須、それ以外の場合は強く推奨 - コンテンツの総合的なレーティング。コンテンツのレーティングを文字列の形式で指定する場合は、次の 2 つのバリエーションを使用できます。
  • レーティング機関は、レーティングの先頭に空白文字を挿入します。例: 「TV-MA」代理店「TVPG」の評価は「TVPG TV-MA」と記述する必要があります。代理店のリストをご覧ください。
  • 値が「RATING NOT KNOWN」(大文字と小文字を区別しない)を使用して、コンテンツの評価が不明であることを示します。
contentRating.author 組織 contentRatingRating を使用している場合は必須 - レーティング機関の名前。承認されているレーティング機関の一覧については、コンテンツ レーティング機関のページをご覧ください。
contentRating.ratingValue テキスト contentRatingRating を使用する場合は必須 - 評価の値。
contentRating.advisoryCode テキスト コンテンツのアドバイザリ コード。指定可能な値は、D、FV、L、S、V です。D = 対話、FV = ファンタジーの暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。
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 テキスト 必須 - このテレビシーズンの名前。
  • 複数の言語で名前を列挙するには、配列を使用します。複数の言語表現の例をご覧ください。
  • 1 つのロケール(言語と国のペア)につき 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 テキスト 強く推奨理由シーズンのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。最大 300 文字。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の言語表現の例をご覧ください。
actor [PersonPerformingGroup、または PerformanceRole] 強く推奨理由シーズンのキャスト メンバーの配列。モデリングのガイダンスについては、こちらをご覧ください。
director Person 強く推奨理由番組の監督の配列。
producer Organization または Person 強く推奨理由シーズンのプロデューサー。
image ImageObject テレビシーズンに関連する画像。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 つのバリエーションを使用できます。
  • レーティング機関は、レーティングの先頭に空白文字を挿入します。例: 「TV-MA」代理店「TVPG」の評価は「TVPG TV-MA」と記述する必要があります。代理店のリストをご覧ください。
  • 値が「RATING NOT KNOWN」(大文字と小文字を区別しない)を使用して、コンテンツの評価が不明であることを示します。
contentRating.author 組織 contentRatingRating を使用している場合は必須 - レーティング機関の名前。承認されているレーティング機関の一覧については、コンテンツ レーティング機関のページをご覧ください。
contentRating.ratingValue テキスト contentRatingRating を使用する場合は必須 - 評価の値。
contentRating.advisoryCode テキスト コンテンツのアドバイザリ コード。指定可能な値は、D、FV、L、S、V です。D = 対話、FV = ファンタジーの暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。

アクターの仕様

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

プロパティ タイプ 説明
actor PersonPerformingGroup、または PerformanceRole 強く推奨理由: キャスト メンバーの配列。
  • 演じる役とキャスト メンバーのキャラクター名がわかっている場合は、PerformanceRole タイプを使用します。この場合、アクターの Person または PerformingGroup は、PerformanceRole オブジェクト内に埋め込まれています。
  • キャスト メンバーが演じている役割が不明な場合は、タイプ Person を使用して個々の俳優を示し、PerformingGroup(複数可)の演奏グループ / バンドの詳細を提供します。

配列を使用して、複数の Person、PerformingGroups、または PerformanceRoles を表します。

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その俳優のウィキペディアのページなどです@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その俳優のウィキペディアのページなどですこれは actor.@id プロパティとは異なる必要があります。

使用できるロール名

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

roleName 説明
「Cameo」 カメオ出演とも呼ばれるカメオ役とは、舞台芸術作品の有名な人物の短い出演です。
「VoiceActor」 声優のパフォーマンスとは、俳優の声が使用されていて、その俳優が画面に表示されない部分を指します。これはアニメーションで最もよく見られますが、俳優の声が別の俳優のスピーチの上に吹き替えられている場合にも発生します。
「倍精度」 ダブルとは、特定の俳優の代わりをして、その人物の顔を見えないようにする人のことです。
「MotionCaptureActor」 MotionCaptureActor は、人間の俳優の行動を記録し、その情報を使用してデジタル キャラクター モデルを 2D または 3D のコンピュータ アニメーションでアニメーション化する人物を指します。

これらの値は通常、Person 型と PerformingGroup 型で受け入れられます。

roleName 説明
「俳優」 俳優または女優とは、演劇の伝統的媒体や、映画、ラジオ、テレビなどの現代メディアでのパフォーマンスでキャラクターを演じる人のことです。
「GuestStar」 「ゲストスターとは、1 つまたは複数のエピソードに登場する架空の役を演じる俳優です。ゲストスターは、メインキャストのメンバーでなくても、重要なキャラクターを繰り返し演じたり、シリーズに何度も登場したりすることがあります。値を「GuestStar」に設定します(出演者がゲスト パフォーマンスや番組に出演している場合)。ゲスト出演はエピソード レベルでのみ指定し、TVSeries レベルでは追加しないでください。
「ゲスト」 「トークショーのゲスト。「GuestStar」はこれは架空の役割で、「ゲスト」という架空の外観です。
「アナウンサー」 アナウンサーとは、番組のオープニングとクロージングのスピーチを配信し、司会者、参加者、有名人のゲストの紹介、入手できる賞品の説明、録画の前に観客の心を掴み、休憩時間には楽しませる人物のことを指します。
"コメンテーター" コメンテーターは、試合やイベントのリアルタイムな解説を、通常はライブ配信中に行います。
"印象派" 印象派や模倣品とは、有名人や漫画の登場人物の音、声、マネリズムを模倣して演技を行うパフォーマーです。
「ホスト」 テレビ番組を紹介、提示、ホストする人物。多くの場合、その番組や視聴者に関するメディエーターの役割を果たします。「ホスト」一般的にノンフィクションの仕事です
「共同主催者」 他のユーザーと共同でイベントやプログラムを主催する人。
「GuestHost」 ゲスト主催者とは、通常はトークショーが開催される主催者であり、参加できない場合に通常の主催者の代わりに番組を主催します。
"Newscaster" テレビのニュース プログラムを通じて、地域、国内、世界規模で起きているニュースやイベントについて一般の人々にプレゼンまたは情報発信する人。
「特派員」 特派員や現場の記者は通常、遠く離れた場所から、雑誌のジャーナリストやコメンテーター、新聞、ラジオ、テレビのニュース、あるいは別のタイプの企業に記事を投稿するエージェントです。
「ShowJudge」 審査員とは、ショーの分野の専門家と見なされることが多く、「審査員」の役割を果たす人のことです。テレビシリーズのコンペティションのオーディションやコンペティションへの参加を批判する動画を作成できます。
パネルメンバー ラジオやテレビのパネルや諮問委員会のメンバー。
「コンテスト参加者」 コンテストやクイズ番組の出場者とは、それに参加する人のことです。
「StoryNarrator」 ナレーターとは、何かをナレーションする人です。特に、小説や物語のある詩の出来事を解説する人物です。
「ミュージカル アーティスト」 「音楽アーティストとは、通常、視聴者の前で定期的に演奏したり、音楽トラックや音楽アルバムを録音したりしている人、グループ、架空のキャラクターです。作曲者や作詞家は、一部の音楽作品のクレジットが主演者としても貢献していることが示唆される場合のみ、このタイプを設定してください。このタイプを使用して、恒久的なミュージシャンまたはミュージシャン グループと、ゲスト ミュージシャンまたはミュージシャン グループをショーに関連付けることができます。

アクターの主な役割と補助的な役割を区別する

テレビ番組でメイン/通常の俳優とゲスト/補助役を区別するには、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"
  }
]

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