このセクションでは、TVSeries
、TVEpisode
、TVSeason
エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。
TVSeason
を完全なエンティティとして指定することは省略可能です。詳細については、TVSeries、TVSeason、TVEpisode の関係をご覧ください。
仕様表
プロパティ | タイプ | 説明 |
---|---|---|
@context |
テキスト | 必須 - 常に ["http:/ に設定します。
|
@type |
テキスト | 必須 - 常に TVSeries に設定します。 |
@id |
URL | 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。@id は次の要件を満たす必要があります。
url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。 |
url |
URL | 必須 - Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は、次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - 番組の名前。
|
titleEIDR |
テキスト | 強く推奨理由- 映画またはテレビの作品を最も一般的なレベルで抽象的に表す EIDR(Entertainment Identifier Registry)ID。 たとえば、「ゲーム オブ スローンズ」という TV シリーズの titleEIDR は「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 文字以内。
|
actor |
Person、PerformingGroup、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 つのバリエーションが使用できます。
|
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 | 必須 - Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は、次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - エピソードの名前。
|
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 プロパティを指定する必要があります。回避策は次のとおりです。
|
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 | 該当する場合は必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。
|
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 文字以内。
|
genre |
テキスト | 関連するすべてのジャンルの順序付きリスト。例 : ["Action", "Fashion", "Environment", "Football"] |
keywords |
テキスト | このコンテンツの説明に使用されるキーワードまたはタグ。キーワードの配列も使用できます。たとえば、["feature, biography"] は、コンテンツを説明するキーワードの配列です。 |
actor |
Person、PerformingGroup、PerformanceRole | 強く推奨理由エピソードの出演者の配列。モデリングのガイダンスについては、こちらをご覧ください。 |
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 つのバリエーションが使用できます。
|
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 |
数値 | エンティティの人気度を示す 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 | 必須 - Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は、次の要件を満たしている必要があります。
urlTemplate プロパティをご覧ください。 |
name |
テキスト | 必須 - この TV シーズンの名前。
|
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 | 該当する場合は必須 - アクションの詳細を提供するアクション マークアップ オブジェクト。
|
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 文字以内。
|
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 つのバリエーションが使用できます。
|
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 | 強く推奨理由: キャスト メンバーの配列。
複数の Person、PerformingGroup、または PerformanceRole を表すには、配列を使用します。 |
Person
型または PerformingGroup
型を使用する
Person または PerformingGroup タイプを使用する場合は、次のプロパティを指定します。
プロパティ | タイプ | 説明 |
---|---|---|
@type |
Person または PerformingGroup | 必須 - 常に Person または PerformingGroup に設定します。 |
@id |
URL | 強く推奨理由- 俳優または演奏グループの識別子(URI 形式)。例: https://example.com/actor/abc。@id は、次の要件を満たす必要があります。
なお、actor プロパティで使用される |
name |
テキスト | 必須 - 俳優/女優/キャスト/演奏グループの名前。 |
sameAs |
URL | 強く推奨理由- 俳優または演奏グループを識別できる参照ウェブページの URL。たとえば、俳優の Wikipedia ページなど。これは @id プロパティとは異なる値にする必要があります。 |
PerformanceRole
タイプの使用
PerformanceRole タイプを使用する場合は、次のプロパティを指定します。
プロパティ | タイプ | 説明 |
---|---|---|
@type |
PerformanceRole | 必須 - 常に PerformanceRole に設定します。 |
roleName |
テキスト | 強く推奨理由- キャスト メンバーが演じた、演奏した、または務めた役割。使用できる値のリストについては、こちらをご覧ください。 |
characterName |
テキスト | 演技やパフォーマンスで演じられたキャラクターの名前。アクター タイプが PerformingGroup の場合は、このフィールドを設定しないでください。 |
actor |
Person または PerformingGroup | 必須 -
|
actor.@type |
Person または PerformingGroup | 必須 - 常に Person または PerformingGroup に設定します。 |
actor.@id |
URL | 強く推奨理由- 俳優または演奏グループの識別子(URI 形式)。例: https://example.com/actor/abc。@id は、次の要件を満たす必要があります。
なお、actor プロパティで使用される |
actor.name |
テキスト | 必須 - 俳優/女優/キャスト/演奏グループの名前。 |
actor.sameAs |
URL | 強く推奨理由- 俳優または演奏グループを識別できる参照ウェブページの URL。たとえば、俳優の Wikipedia ページなど。これは actor.@id プロパティとは異なる値にする必要があります。 |
使用できるロール名
これらの値では、actor.@type
を Person
にする必要があります。
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
エンティティに追加されていないことを確認します。
例
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
プロパティの例
俳優の役割が不明な場合は、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"
}
]
関連ページ
これらのプロパティに関連するトピックについては、次のページを確認してください。