ここでは、TVSeries
、TVEpisode
、TVSeason
のエンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。
TVSeason
を完全なエンティティとして提供することはオプションです。詳しくは、TVSeries、TVSeason、TVEpisode リレーションをご覧ください。
仕様表
テレビシリーズ
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定
|
@type |
テキスト | 必須 - 常に TVSeries に設定されます。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。例: https://example.com/1234abc@id は、次の要件を満たしている必要があります。
url は識別子としてすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳しくは、識別子のセクションをご覧ください。 |
url |
URL | 必須 - コンテンツの正規 URL。Google はこの URL を使用して、フィード内のコンテンツを Google のデータベースのコンテンツと照合します。url 次の要件を満たす必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - 番組の名前。
|
titleEIDR |
テキスト | 強く推奨理由- EIDR(Entertainment Identifier Registry)の識別子。最も一般的または抽象的なレベルで、映画やテレビの作品を表します。 たとえば、「Game of Thrones」という TVSeries のタイトル title は「10.5240/C1B5-3BA1-8991-A571-8472-W」になります。 |
potentialAction |
WatchAction | 必須(省略可) - アクションの詳細を提供するアクション マークアップ オブジェクト。
|
sameAs |
URL | 強く推奨理由番組を識別できる参照ウェブページの URL。たとえば、番組の Wikipedia ページなど。url プロパティとは異なる値を指定してください。 |
inLanguage |
テキスト | シリーズのオリジナル言語(BCP 47 形式)。 |
genre |
テキスト | 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"] |
keywords |
テキスト | このコンテンツを説明するために使用されるキーワードまたはタグ。キーワードの配列も使用できます。たとえば [feature, biography] は、コンテンツを説明するキーワードの配列になります。 |
releasedEvent |
PublicationEvent 、FeaturedEvent 、または ExclusiveEvent |
強く推奨理由- PublicationEvent は、映画のオリジナル公開日など、パブリッシャーによるコンテンツのオリジナル(グローバルまたはローカル)のリリースを指定するために使用されます。さらに、 FeaturedEvent を使用して、このコンテンツをオリジナル、注目のコンテンツ、特別コンテンツなどとしてマーケティングすることを示します。ExclusiveEvent : サービスが独占配信権を持ち、いつ、どこで参加するかを指定します。詳細と例については、サンプル セクションをご覧ください。 |
releasedEvent.@type |
テキスト | 必須 - このプロパティは必ず次のいずれかに設定します。
|
releasedEvent.location |
国 | 必須 - このイベントに関連付けられている地域。PublicationEvent の場合、これはコンテンツが公開された地域です。FeaturedEvent と ExclusiveEvent の場合、これはコンテンツを掲載する地域、または除外される地域です。国は ISO 3166 コードを使用します。世界の任意の場所を示すには、 EARTH に設定します。 |
releasedEvent.startDate |
Date または DateTime | 推奨 - ExclusiveEvent の場合は必須 - エンティティの公開の開始日。PublicationEvent の場合は、このエンティティの最初のリリース日(映画が映画館で最初に公開された日付など)を示します。ExclusiveEvent と FeaturedEvent の場合は、エンティティが排他的または注目の開始日になります。 |
releasedEvent.endDate |
Date または DateTime | 推奨 - ExclusiveEvent の場合は必須です - ExclusiveEvent と FeaturedEvent タイプにのみ適用されます。ExclusiveEvent の場合、これはコンテンツの権利の有効期限を表します。FeaturedEvent の場合、プロバイダがエンティティを明示した最後の日付を表します。コンテンツが永続的に独占的または注目のコンテンツとして表示される場合は、 endDate を現在の日付から 20 年に設定します。 |
releasedEvent.publishedBy |
Organization または Person | 省略可 - このエンティティを公開した組織またはユーザー。 |
description |
テキスト | 強く推奨理由番組のあらすじ。プロットのあらすじは、事実の要約よりも優先されます。半角 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 つのバリエーションを使用できます。
|
contentRating.author |
テキストまたは組織 | contentRating が Rating を使用する場合は必須です - 評価機関の名前。利用可能なレーティング機関の一覧については、コンテンツ レーティング機関のページをご覧ください。 |
contentRating.ratingValue |
テキスト | contentRating が Rating を使用する場合に必須 - 評価の値。 |
contentRating.advisoryCode |
テキスト | コンテンツのアドバイザリ コード。許容される値には、D、FV、L、S、V があります。D = 会話、FV = ファンタジー暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。 |
テレビ番組のエピソード
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定
|
@type |
テキスト | 必須 - 常に TVEpisode に設定されます。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。例: https://example.com/1234abc@id は、次の要件を満たしている必要があります。
url は識別子としてすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳しくは、識別子のセクションをご覧ください。 |
url |
URL | 必須 - コンテンツの正規 URL。Google はこの URL を使用して、フィード内のコンテンツを Google のデータベースのコンテンツと照合します。url 次の要件を満たす必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - エピソードの名前。
|
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 プロパティを指定する必要があります。回避策は次のとおりです。
|
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 | 必須(省略可) - アクションの詳細を提供するアクション マークアップ オブジェクト。
|
sameAs |
強く推奨理由URL | エピソードを識別できる参照ウェブページの URL。たとえば、エピソードの Wikipedia ページなど。url プロパティとは異なる値を指定してください。 |
duration |
時間 | エピソードのランタイムは ISO 8601 形式で指定します。「PT00H00M」の形式を使用してください。 |
releasedEvent |
PublicationEvent 、FeaturedEvent 、または ExclusiveEvent |
強く推奨理由- PublicationEvent は、映画のオリジナル公開日など、パブリッシャーによるコンテンツのオリジナル(グローバルまたはローカル)のリリースを指定するために使用されます。さらに、 FeaturedEvent を使用して、このコンテンツをオリジナル、注目のコンテンツ、特別コンテンツなどとしてマーケティングすることを示します。ExclusiveEvent : サービスが独占配信権を持ち、いつ、どこで参加するかを指定します。詳細と例については、サンプル セクションをご覧ください。 |
releasedEvent.@type |
テキスト | 必須 - このプロパティは必ず次のいずれかに設定します。
|
releasedEvent.location |
国 | 必須 - このイベントに関連付けられている地域。PublicationEvent の場合、これはコンテンツが公開された地域です。FeaturedEvent と ExclusiveEvent の場合、これはコンテンツを掲載する地域、または除外される地域です。国は ISO 3166 コードを使用します。世界の任意の場所を示すには、 EARTH に設定します。 |
releasedEvent.startDate |
Date または DateTime | 推奨 - ExclusiveEvent の場合は必須 - エンティティの公開の開始日。PublicationEvent の場合は、このエンティティの最初のリリース日(映画が映画館で最初に公開された日付など)を示します。ExclusiveEvent と FeaturedEvent の場合は、エンティティが排他的または注目の開始日になります。 |
releasedEvent.endDate |
Date または DateTime | 推奨 - ExclusiveEvent の場合は必須です - ExclusiveEvent と FeaturedEvent タイプにのみ適用されます。ExclusiveEvent の場合、これはコンテンツの権利の有効期限を表します。FeaturedEvent の場合、プロバイダがエンティティを明示した最後の日付を表します。コンテンツが永続的に独占的または注目のコンテンツとして表示される場合は、 endDate を現在の日付から 20 年に設定します。 |
releasedEvent.publishedBy |
Organization または Person | 省略可 - このエンティティを公開した組織またはユーザー。 |
description |
テキスト | 強く推奨理由エピソードのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。半角 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 つのバリエーションを使用できます。
|
contentRating.author |
テキストまたは組織 | contentRating が Rating を使用する場合は必須です - 評価機関の名前。利用可能なレーティング機関の一覧については、コンテンツ レーティング機関のページをご覧ください。 |
contentRating.ratingValue |
テキスト | contentRating が Rating を使用する場合に必須 - 評価の値。 |
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"}] に設定
|
@type |
テキスト | 必須 - 常に TVSeason に設定されます。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。例: https://example.com/1234abc@id は、次の要件を満たしている必要があります。
url は識別子としてすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳しくは、識別子のセクションをご覧ください。 |
url |
URL | 必須 - コンテンツの正規 URL。Google はこの URL を使用して、フィード内のコンテンツを Google のデータベースのコンテンツと照合します。url 次の要件を満たす必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - このテレビシーズンの名前。
|
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 | 必須(省略可) - アクションの詳細を提供するアクション マークアップ オブジェクト。
|
sameAs |
URL | 強く推奨理由シーズンを識別できる参照ウェブページの URL。たとえば、シーズンの Wikipedia ページなど。url プロパティとは異なる値を指定してください。 |
releasedEvent |
PublicationEvent 、FeaturedEvent 、または ExclusiveEvent |
強く推奨理由- PublicationEvent は、出版社のオリジナル(全世界またはローカル)のリリースを指定する場合に使用します。たとえば、映画のオリジナル公開日などを指定します。さらに、 FeaturedEvent を使用して、このコンテンツがオリジナル、注目の映画、特別コンテンツなどとしてマーケティングされることを示します。ExclusiveEvent に、このサービスが独占配信の権利と地域と時間が含まれることを指定します。詳細と例については、サンプル セクションをご覧ください。 |
releasedEvent.@type |
テキスト | 必須 - このプロパティは必ず次のいずれかに設定します。
|
releasedEvent.location |
国 | 必須 - このイベントに関連付けられている地域。PublicationEvent の場合、これはコンテンツが公開された地域です。FeaturedEvent と ExclusiveEvent の場合、これはコンテンツを掲載する地域、または除外される地域です。国は ISO 3166 コードを使用します。世界の任意の場所を示すには、 EARTH に設定します。 |
releasedEvent.startDate |
Date または DateTime | 推奨 - ExclusiveEvent の場合は必須 - エンティティの公開の開始日。PublicationEvent の場合は、このエンティティの最初のリリース日(映画が映画館で最初に公開された日付など)を示します。ExclusiveEvent と FeaturedEvent の場合は、エンティティが排他的または注目の開始日になります。 |
releasedEvent.endDate |
Date または DateTime | 推奨 - ExclusiveEvent の場合は必須です - ExclusiveEvent と FeaturedEvent タイプにのみ適用されます。ExclusiveEvent の場合、これはコンテンツの権利の有効期限を表します。FeaturedEvent の場合、プロバイダがエンティティを明示した最後の日付を表します。コンテンツが永続的に独占的または注目のコンテンツとして表示される場合は、 endDate を現在の日付から 20 年に設定します。 |
releasedEvent.publishedBy |
Organization または Person | 省略可 - このエンティティを公開した組織またはユーザー。 |
description |
テキスト | 強く推奨理由シーズンのあらすじ。プロットのあらすじは、事実の要約よりも優先されます。半角 300 文字(全角 150 文字)以内。
|
actor |
[人物]、[PerformingGroup、PerformanceRole] | 強く推奨理由シーズンのキャスト メンバーの配列。モデリングについてはこちらをご覧ください。 |
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 つのバリエーションを使用できます。
|
contentRating.author |
テキストまたは組織 | contentRating が Rating を使用する場合は必須です - 評価機関の名前。利用可能なレーティング機関の一覧については、コンテンツ レーティング機関のページをご覧ください。 |
contentRating.ratingValue |
テキスト | contentRating が Rating を使用する場合に必須 - 評価の値。 |
contentRating.advisoryCode |
テキスト | コンテンツのアドバイザリ コード。許容される値には、D、FV、L、S、V があります。D = 会話、FV = ファンタジー暴力、L = 言語、S = 性的なコンテンツ、V = 暴力。 |
アクターの仕様
TVSeries
、TVEpisode
、TVSeason
エンティティ タイプの actor
プロパティを使用すると、俳優の名前や、テレビ番組で果たす役割など、俳優に関する詳細情報を指定できます。以降のセクションでは、同じ定義と、その使用法を明確に説明するいくつかの例について説明します。
プロパティ | タイプ | 説明 |
---|---|---|
actor |
Person または PerformingGroup または PerformanceRole | 強く推奨理由: キャスト メンバーの配列。
複数の Persons、PerformingGroups、PerformanceRole を表す配列を使用します。 |
Person
型または PerformingGroup
型を使用する
Person 型または PerformingGroup 型を使用する場合は、以下のプロパティを指定します。
プロパティ | タイプ | 説明 |
---|---|---|
@type |
Person または PerformingGroup | 必須 - 常に Person または PerformingGroup に設定します。 |
@id |
URL | 強く推奨理由- アクターまたはパフォーマンス グループ ID(URI 形式)。例: https://example.com/actor/abc@id は次の要件を満たしている必要があります。
actor プロパティで使用する |
name |
テキスト | 必須 - 俳優/女優/キャスト メンバー/パフォーマンス グループの名前。 |
sameAs |
URL | 強く推奨理由- アクターやパフォーマンス グループを識別できる参照ウェブページの URL(アクターの Wikipedia ページなど)。@id プロパティとは異なる値を指定してください。 |
PerformanceRole
タイプを使用する
PerformanceRole タイプを使用する場合、以下のプロパティを指定します。
プロパティ | タイプ | 説明 |
---|---|---|
@type |
パフォーマンス ロール | 必須 - 常に PerformanceRole に設定 |
roleName |
テキスト | 強く推奨理由- キャスト メンバーが担当、演じた、または果たした役割。指定できる値については、こちらをご覧ください。 |
characterName |
テキスト | 役やロールを担うキャラクターの名前。アクタータイプが PerformingGroup の場合は、このフィールドを設定しないでください。 |
actor |
Person または PerformingGroup | 必須 -
|
actor.@type |
Person または PerformingGroup | 必須 - 常に Person または PerformingGroup に設定します。 |
actor.@id |
URL | 強く推奨理由- アクターまたはパフォーマンス グループ ID(URI 形式)。例: https://example.com/actor/abc@id は次の要件を満たしている必要があります。
actor プロパティで使用する |
actor.name |
テキスト | 必須 - 俳優/女優/キャスト メンバー/パフォーマンス グループの名前。 |
actor.sameAs |
URL | 強く推奨理由- アクターやパフォーマンス グループを識別できる参照ウェブページの URL(アクターの Wikipedia ページなど)。これは、actor.@id プロパティとは別にする必要があります。 |
使用できるロール名
これらの値を使用するには、actor.@type
が Person
である必要があります。
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
エンティティに追加されていないことを確認します。
例
TVSeries
、TVEpisode
、TVSeason
の例
テレビシリーズ
{
"@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"
}
]
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。