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

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

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

仕様表

プロパティ タイプ 説明
@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)ID。

たとえば、「ゲーム オブ スローンズ」という TV シリーズの 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 PublicationEventFeaturedEventExclusiveEvent 強く推奨理由- 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 PersonPerformingGroupPerformanceRole 強く推奨理由シリーズの出演者の配列。モデリングのガイダンスについては、こちらをご覧ください。
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 つのバリエーションが使用できます。
  • 格付けの前に空白を挟んで格付け機関を付加します。たとえば、米国の代理店「TVPG」からの「TV-MA」格付けは、「TVPG TV-MA」と記述します。代理店のリストをご覧ください。
  • コンテンツの評価が不明であることを示す値「RATING NOT KNOWN」(大文字と小文字を区別しない)。
contentRating.author 組織 contentRatingRating が使用されている場合は必須 - 格付け機関の名前。承認されているレーティング機関の一覧については、コンテンツのレーティング機関のページをご覧ください。
contentRating.ratingValue テキスト contentRatingRating が使用されている場合必須 - 格付けの値。
contentRating.advisoryCode テキスト コンテンツに関する注意事項のコード。指定できる値は、D、FV、L、S、V です。D = 会話、FV = ファンタジーの暴力、L = 言語、S = 性的コンテンツ、V = 暴力。
プロパティ タイプ 説明
@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)ID。

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

たとえば、「Game of Thrones」という TV シリーズのシーズン 1 の最初のエピソード(タイトル EIDR は「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」)には 1 つの編集(「10.5240/FB97-C847-2969-D0AB-ECD1-C」など)があります。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 PublicationEventFeaturedEventExclusiveEvent 強く推奨理由- 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 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 = 会話、FV = ファンタジーの暴力、L = 言語、S = 性的コンテンツ、V = 暴力。
identifier PropertyValue 強く推奨理由- このエンティティを明確に識別する外部 ID またはその他の ID。複数の識別子を使用できます。詳細については、「識別子プロパティ」セクションをご覧ください。
popularityScore PopularityScoreSpecification 強く推奨理由Google が他のシグナルと組み合わせてユーザーのために再生するメディアを決定するために使用するスコア。このスコアは、カタログ内の他のコンテンツと比較したそのコンテンツの人気度を表します。そのため、スコアの基準は、フィード全体、カタログ内のすべてのエンティティ間で一貫している必要があります。デフォルトで、エンティティの人気度スコアは 0 に設定されます。
popularityScore.@type テキスト 常に PopularityScoreSpecification に設定。
popularityScore.value 数値 エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。
popularityScore.eligibleRegion この人気度スコアを適用可能な地域。人気度スコアがグローバルに適用可能な場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。
Note: ロケール固有の人気度は、グローバル(EARTH)人気度より優先されます。
プロパティ タイプ 説明
@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)ID。

たとえば、「ゲーム オブ スローンズ」という TVSeries のシーズン 1 の 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 PublicationEventFeaturedEventExclusiveEvent 強く推奨理由- 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 [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 = 会話、FV = ファンタジーの暴力、L = 言語、S = 性的コンテンツ、V = 暴力。

アクターの仕様

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 値に使用するドメインは、組織が所有している必要があります。

なお、actor プロパティで使用される @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 値に使用するドメインは、組織が所有している必要があります。

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

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

使用できるロール名

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

roleName 説明
「Cameo」 カメオ出演とは、演劇作品で著名人が短時間出演することを指します。
「VoiceActor」 音声パフォーマンスとは、俳優の声は使用されるものの、俳優が画面に登場しないパフォーマンスです。これはアニメーションでよく見られますが、俳優の声が別の俳優の演技に吹き替えられている場合にも発生します。
「ダブル」 ダブルとは、顔が映らないように別の俳優の代わりになる人物です。
"MotionCaptureActor" MotionCaptureActor は、人間の俳優の動作を記録し、その情報を使用して 2D または 3D コンピュータ アニメーションでデジタル キャラクター モデルをアニメーション化する人物を指します。

これらの値は、通常、Person 型と PerformingGroup 型で使用できます。

roleName 説明
「Actor」 俳優は、伝統的なメディアである劇場や、映画、ラジオ、テレビなどの現代のメディアで、演技の中でキャラクターを演じる人です。
「GuestStar」 「ゲスト出演とは、架空の役を演じ、1 話または数話に出演する俳優のことです。ゲスト出演者は、メイン キャストではないにもかかわらず、重要な役柄を演じ、シリーズに何度も登場することがあります。キャストがゲスト出演している場合や、番組にゲスト出演している場合は、値を「GuestStar」に設定します。ゲスト出演者はエピソード単位でのみ指定し、TVSeries レベルでは追加しないでください。
「ゲスト」 「トークショーのゲスト。「GuestStar」は架空の役割ですが、「Guest」は架空ではない出演です。
「アナウンサー」 アナウンサーは、番組のオープニングとエンディングのスピーチを読み上げ、司会者、出場者、有名人のゲストを紹介し、賞品について説明します。また、収録前に観客を盛り上げ、休憩中に観客を楽しませます。
「Commentator」 コメンテーターは、通常はライブ放送中に、試合やイベントの実況を行います。
「印象派」 ものまね芸人は、有名人やアニメのキャラクターの音声、声、仕草を真似て演技するパフォーマーです。
「ホスト」 テレビ番組の紹介、発表、司会を行う人物。多くの場合、番組と視聴者の仲介役を務めます。「ホスト」は通常、ノンフィクションの役割です。
「CoHost」 他のユーザーと共同でイベントやプログラムを主催するユーザー。
「GuestHost」 ゲスト ホストは、通常はトークショーのホストで、通常のホストが不在の場合に番組をホストします。
「ニュースキャスター」 地域、国内、国際規模で発生したニュースや出来事をテレビのニュース番組で視聴者に伝える人物。
「Correspondent」 通信員または現地レポーターは通常、雑誌のジャーナリストまたはコメンテーター、または新聞、ラジオ、テレビのニュース、または他のタイプの会社に、遠隔地(多くの場合遠く離れた場所)からレポートを提供するエージェントです。
「ShowJudge」 審査員は、番組の分野の専門家とみなされることが多い人物で、テレビシリーズのオーディションを受けて競技に参加する出場者を批評する「審査員」の役割を担っています。
「パネリスト」 ラジオまたはテレビのパネルの討論パネルまたはアドバイザリー パネルのメンバー。
「Contestant」 コンテストやゲーム番組の参加者は、そのコンテストやゲーム番組に参加する人物です。
「StoryNarrator」 ナレーターは、何かを語る人、特に小説や物語詩の出来事を語る登場人物です。
"MusicalArtist" 「音楽アーティストとは、通常、観衆の前で定期的に演奏したり、楽曲や音楽アルバムを録音したりする個人、グループ、架空のキャラクターを指します。作曲者と作詞者は、一部の楽曲のクレジットでメイン パフォーマーとしても貢献していることが示されている場合にのみ、このタイプを指定してください。このタイプは、常設のミュージシャンまたはミュージシャン グループ、ゲストのミュージシャンまたはミュージシャン グループを番組に関連付けるために使用できます。

俳優の主役と助演の区別

テレビ番組の主演/レギュラー キャストとゲスト/脇役のキャストを区別するには、TVSeries エンティティにのみメインキャストを追加し、TVEpisode エンティティにゲストキャストまたは脇役のキャストのみを追加します。メイン/レギュラー キャストが TVEpisode エンティティに追加されていないことを確認します。

TVSeriesTVEpisodeTVSeason の例

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

演奏ロールのメタデータが不明な場合は、人物 または 演奏グループ のいずれかを使用して、俳優情報を指定することをおすすめします。この情報が既知である場合は、 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"
  }
]

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