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

ここでは、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 必須 - コンテンツの正規 URL。Google はこの URL を使用して、フィード内のコンテンツを Google のデータベースのコンテンツと照合します。
url次の要件を満たす必要があります。
  • url はグローバルに一意である必要があります
  • url には、Google がクロールできる有効な正規 URL を含める必要があります。
再生のディープリンクについては、代わりに target オブジェクトの urlTemplate プロパティをご覧ください。
name テキスト 必須 - 番組の名前。
  • 複数の言語で名前を列挙するには、配列を使用します。「複数の地域と言語」の例をご覧ください。
  • 1 つのロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
titleEIDR テキスト 強く推奨理由- EIDR(Entertainment Identifier Registry)の識別子。最も一般的または抽象的なレベルで、映画やテレビの作品を表します。

たとえば、「Game of Thrones」という TVSeries のタイトル title は「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 の場合は必須です - ExclusiveEventFeaturedEvent タイプにのみ適用されます。

ExclusiveEvent の場合、これはコンテンツの権利の有効期限を表します。

FeaturedEvent の場合、プロバイダがエンティティを明示した最後の日付を表します。

コンテンツが永続的に独占的または注目のコンテンツとして表示される場合は、endDate を現在の日付から 20 年に設定します。
releasedEvent.publishedBy Organization または Person 省略可 - このエンティティを公開した組織またはユーザー。
description テキスト 強く推奨理由番組のあらすじ。プロットのあらすじは、事実の要約よりも優先されます。半角 300 文字(全角 150 文字)以内。
  • 複数の言語で説明をマークアップするには、配列を使用します。「複数の地域と言語」の例をご覧ください。
actor Person または PerformingGroup または PerformanceRole 強く推奨理由シリーズのキャスト メンバーの配列。モデリングについてはこちらをご覧ください。
director 担当者 強く推奨理由番組の監督。
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 Number エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。
popularityScore.eligibleRegion この人気度スコアを適用可能な地域。人気度スコアがグローバルに適用可能な場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。
Note: 言語 / 地域固有の人気度はグローバル(EARTH)の人気度より高くなる
review 復習 テレビシリーズの評価を確認する
review.reviewRating 評価 review が指定されている場合は必須: レビューで提示される評価を指定するために使用します。
contentRating テキストまたは評価 アダルト コンテンツでは必須、それ以外の場合は強く推奨 - 全体的なコンテンツ レーティング。コンテンツのレーティングがテキスト文字列で提供される場合、次の 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 必須 - コンテンツの正規 URL。Google はこの URL を使用して、フィード内のコンテンツを Google のデータベースのコンテンツと照合します。
url次の要件を満たす必要があります。
  • url はグローバルに一意である必要があります
  • url には、Google がクロールできる有効な正規 URL を含める必要があります。
再生のディープリンクについては、代わりに target オブジェクトの urlTemplate プロパティをご覧ください。
name テキスト 必須 - エピソードの名前。
  • 複数の言語で名前を列挙するには、配列を使用します。複数の言語表現の例をご覧ください。
  • 1 つのロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
titleEIDR テキスト 強く推奨理由- EIDR(Entertainment Identifier Registry)の識別子。最も一般的または抽象的なレベルで、映画やテレビの作品を表します。

たとえば、「ゲーム・オブ・スローンズ」として知られる TV シリーズの最初のシーズンの titleEIDR は「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」とします。
editEIDR テキスト 強く推奨理由- 映画やテレビの作品の特定の編集内容やエディションを表す EIDR(Entertainment Identifier Registry)

たとえば、「Game of Thrones」として知られる TVSeries の最初のエピソードでは、TitleEIDR が「10.5240/B6A6-1B32-B5E5-D5CB-6B84-X」の場合、編集は 1 個、
editEIDR を指定する場合、
titleEIDR プロパティは必須です。
inLanguage テキスト シリーズのオリジナル言語(BCP 47 形式)。
episodeNumber Integer 必須 - このエピソードがシーズン内の位置に基づいている位置を示す番号。episodeNumber はシーズンごとに再開する必要があります。つまり、各シーズンの最初のエピソードは 1 である必要があります。
partOfSeason テレビ番組のシーズン 必須 - このエピソードが属しているテレビシーズン。

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 Integer 必須 - このシーズンが TV シリーズ内の順序で何番目かを示す数値。
partOfSeries テレビシリーズ 必須 - このエピソードが属している 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 の場合は必須です - ExclusiveEventFeaturedEvent タイプにのみ適用されます。

ExclusiveEvent の場合、これはコンテンツの権利の有効期限を表します。

FeaturedEvent の場合、プロバイダがエンティティを明示した最後の日付を表します。

コンテンツが永続的に独占的または注目のコンテンツとして表示される場合は、endDate を現在の日付から 20 年に設定します。
releasedEvent.publishedBy Organization または Person 省略可 - このエンティティを公開した組織またはユーザー。
description テキスト 強く推奨理由エピソードのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。半角 300 文字(全角 150 文字)以内。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の言語表現の例をご覧ください。
genre テキスト 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"]
keywords テキスト このコンテンツを説明するために使用されるキーワードまたはタグ。キーワードの配列も使用できます。たとえば [feature, biography] は、コンテンツを説明するキーワードの配列になります。
actor Person または PerformingGroup または PerformanceRole 強く推奨理由エピソードのキャスト メンバーの配列。モデリングについてはこちらをご覧ください。
director 担当者 強く推奨理由エピソードのディレクター。
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 テキストまたは評価 アダルト コンテンツでは必須、それ以外の場合は強く推奨 - 全体的なコンテンツ レーティング。コンテンツのレーティングがテキスト文字列で提供される場合、次の 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 Number エンティティの人気度を示す 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 必須 - コンテンツの正規 URL。Google はこの URL を使用して、フィード内のコンテンツを Google のデータベースのコンテンツと照合します。
url次の要件を満たす必要があります。
  • url はグローバルに一意である必要があります
  • url には、Google がクロールできる有効な正規 URL を含める必要があります。
再生のディープリンクについては、代わりに target オブジェクトの urlTemplate プロパティをご覧ください。
name テキスト 必須 - このテレビシーズンの名前。
  • 複数の言語で名前を列挙するには、配列を使用します。複数の言語表現の例をご覧ください。
  • 1 つのロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
titleEIDR テキスト 強く推奨理由- EIDR(Entertainment Identifier Registry)の識別子。最も一般的または抽象的なレベルで、映画やテレビの作品を表します。

たとえば、「ゲーム・オブ・スローンズ」として知られる TV シリーズの最初のシーズンの titleEIDR は「10.5240/FD91-C72C-4161-FCBA-058B-1」です。
seasonNumber Integer 必須 - このシーズンが TV シリーズ内の順序で何番目かを示す数値。
partOfSeries テレビシリーズ 必須 - このシーズンが属している 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 の場合は必須です - ExclusiveEventFeaturedEvent タイプにのみ適用されます。

ExclusiveEvent の場合、これはコンテンツの権利の有効期限を表します。

FeaturedEvent の場合、プロバイダがエンティティを明示した最後の日付を表します。

コンテンツが永続的に独占的または注目のコンテンツとして表示される場合は、endDate を現在の日付から 20 年に設定します。
releasedEvent.publishedBy Organization または Person 省略可 - このエンティティを公開した組織またはユーザー。
description テキスト 強く推奨理由シーズンのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。半角 300 文字(全角 150 文字)以内。
  • 複数の言語で説明をマークアップするには、配列を使用します。複数の言語表現の例をご覧ください。
actor [人物]、[PerformingGroupPerformanceRole] 強く推奨理由シーズンのキャスト メンバーの配列。モデリングについてはこちらをご覧ください。
director 担当者 強く推奨理由番組の監督の配列。
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 Number エンティティの人気度を示す 0 以上の数値。スコアが高いほど人気度が高いことを意味します。
popularityScore.eligibleRegion この人気度スコアを適用可能な地域。人気度スコアがグローバルに適用可能な場合は、EARTH に設定します。デフォルトでは、このプロパティは EARTH に設定されています。
Note: 言語 / 地域固有の人気度はグローバル(EARTH)の人気度より高くなる
review 復習 テレビシーズンのレーティングを確認する
review.reviewRating 評価 review が指定されている場合は必須: レビューで提示される評価を指定するために使用します。
contentRating テキストまたは評価 アダルト コンテンツでは必須、それ以外の場合は強く推奨 - 全体的なコンテンツ レーティング。コンテンツのレーティングがテキスト文字列で提供される場合、次の 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 Person または PerformingGroup または PerformanceRole 強く推奨理由: キャスト メンバーの配列。
  • 役割を担い、必要に応じてキャスト メンバーのキャラクター名がわかっている場合は、タイプ PerformanceRole を使用します。この場合、アクター Person または PerformingGroupPerformanceRole オブジェクトに埋め込まれます。
  • タイプ Person を使用して個々の俳優を示すか、PerformingGroup を使用してキャスト メンバーの役割が不明なときに出演するグループ / バンドの詳細を指定します。

複数の Persons、PerformingGroups、PerformanceRole を表す配列を使用します。

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

Person 型または PerformingGroup 型を使用する場合は、以下のプロパティを指定します。

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

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

name テキスト 必須 - 俳優/女優/キャスト メンバー/パフォーマンス グループの名前。
sameAs URL 強く推奨理由- アクターやパフォーマンス グループを識別できる参照ウェブページの URL(アクターの Wikipedia ページなど)。@id プロパティとは異なる値を指定してください。

PerformanceRole タイプを使用する

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

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

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

actor.name テキスト 必須 - 俳優/女優/キャスト メンバー/パフォーマンス グループの名前。
actor.sameAs URL 強く推奨理由- アクターやパフォーマンス グループを識別できる参照ウェブページの URL(アクターの Wikipedia ページなど)。これは、actor.@id プロパティとは別にする必要があります。

使用できるロール名

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

roleName 説明
「カメオ」 カメオ出演とは、カメオ出演とも呼ばれる、舞台芸術作品における有名な人物の簡単な演技を指します。
「VoiceActor」 音声パフォーマンスとは、アクターの声は使用されているが、そのアクターが画面に現れない状態を指します。これは、アニメーションでよく見られますが、ある俳優の声が別の俳優の吹き替えに吹き替えられたときにも発生します。
「ダブル」 ダブルとは、別の人物の顔を見えないようにする人のことです。
「MotionCaptureActor」 MotionCaptureActor とは、人間のアクターのアクションを記録し、その情報を使用して 2D または 3D コンピュータ アニメーションでデジタル キャラクター モデルをアニメーション化する人のことです。

一般に、これらの値は Person 型と PerformingGroup 型で受け入れられます。

roleName 説明
「アクター」 俳優、女優とは、演劇の従来型のメディアや、映画、ラジオ、テレビなどの現代メディアでパフォーマンスを演じる人のことです。
「GuestStar」 「ゲストスターとは、架空の役割を果たし、1 つまたは複数のエピソードに登場する俳優です。ゲストスターは、繰り返し登場する重要なキャラクターの登場人物である場合、メイン キャストのメンバーではなくても、シリーズに何度も登場することがあります。キャストが出演する場合や番組のゲストである場合は、値を「GuestStar」に設定します。ゲストスターはエピソード レベルでのみ指定し、TVSeries レベルでは追加しないでください。
「ゲスト」 「トークショーのゲスト。「GuestStar」は架空の役割ですが、「Guest」は架空の外観ではありません。
「アナウンサー」 アナウンサーとは、ショーのオープニング メッセージやクロージング スピーチを配信し、司会者、出場者、著名人のゲストを紹介し、利用できる賞品について説明し、休憩中にオーディエンスを温かく保ちます。
「閲覧者(コメント可)」 コメンテーターは、ゲームやイベントに関するリアルタイムの解説を、通常はライブ配信中に提供します。
「Impressionist」 印象派(模倣)は、著名人や漫画のキャラクターの音、声、マインドリズムを模倣した行為を行う人物です。
「ホスト」 テレビ番組を紹介、発表、ホストする人。多くの場合、プログラムおよび視聴者に対する仲介役を務めます。通常、「ホスト」はノンフィクションの役割です。
「共同主催者」 別の人と一緒にイベント/プログラムを主催する人。
「GuestHost」 ゲストホストは、通常はトークショーの主催者です。ホストが利用できない場合は、通常のホストの代わりにプログラムを使用してホストします。
「Newscaster」 テレビ番組のニュース プログラムを通じて、地域、国内、国際規模で行われるニュースやイベントについて一般の人に対して発表や告知を行う人。
「取り次ぎ者」 対応する記者または舞台裏の記者とは、通常、雑誌のジャーナリストまたは評論家、あるいは新聞、ラジオまたはテレビのニュース、あるいはその他のタイプの企業に対して、遠隔地の、多くの場合遠く離れた場所から報道を行うニュース メディアのことです。
「ShowJudge」 審査員とは、テレビ番組の分野の専門家であり、テレビシリーズのオーディションに応募し審査に参加する参加者に「ジャッジ」の役割を担うことが多い人のことです。
「パネリスト」 ラジオやテレビのパネルでディスカッションや勧告を行うメンバー。
「出場者」 コンテストやゲームショーの参加者とは、コンテストに参加する人のことです。
「StoryNarrator」 ナレーターとは、特に小説や物語の出来事を解説する人物を指します。
「MusicalArtist」 {0}音楽アーティストとは、通常、オーディエンスの前で定期的に演奏する人物、グループや架空のキャラクター、または音楽トラックや音楽アルバムを録音した人物を指します。作曲者や作詞家は、一部の音楽作品のクレジットがメイン パフォーマーとしての役割を果たしていることを示唆している場合にのみ、このタイプにする必要があります。このタイプを使用すると、永続的なミュージシャンやミュージシャン グループを、ゲスト ミュージシャンまたはミュージシャン グループを番組に関連付けることができます。

アクターの主な役割と補助の役割の違い

テレビ番組のメイン/標準俳優とゲスト/サポート俳優を区別するには、メイン キャストを 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 プロパティの例

アクターの役割が不明

アクターのロールが不明な場合は、個人 パフォーミング グループ タイプを使用してアクター情報のみ提供することをおすすめします。

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

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