Markup-Eigenschaften von Serien

Dieser Abschnitt enthält Details zu den Eigenschaften des Inhalts-Markups für die Entitätstypen TVSeries, TVEpisode und TVSeason.

Die Angabe von TVSeason als vollständiges Element ist optional. Weitere Informationen finden Sie im Abschnitt Beziehungen zwischen TVSeries, TVSeason und TVEpisode.

Spezifikationstabelle

TVSeries

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: immer auf ["http://schema.org", {"@language": "xx"}]
    festgelegt
  • Dabei ist xx die Sprache der Strings im Feed. Für jeden Stammentitätskontext muss „@language“ auf den entsprechenden Sprachcode im BCP-47-Format festgelegt sein. Wenn die Sprache beispielsweise Spanisch eingestellt ist, wird angenommen, dass die Namen auf Spanisch sind, auch wenn die Untertitelsprache auf Englisch ist.
@type Text Erforderlich: Immer auf TVSeries gesetzt.
@id URL Erforderlich: Kennzeichnung des Inhalts im URI-Format, z. B. https://beispiel.de/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog
  • Die ID sollte immer gleich bleiben, auch wenn sich die URL-Property der Sendung ändert. Er wird als undurchsichtiger String behandelt und muss kein gültiger Link sein.
  • In Form von Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da der url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, den url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL des Inhalts, die Google verwendet, um den Inhalt Ihres Feeds mit den Inhalten in den Google-Datenbanken abzugleichen.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die Google crawlen kann.
Weitere Informationen zum Deeplink der Wiedergabe finden Sie stattdessen in der urlTemplate-Eigenschaft des Ziel-Objekts.
name Text Erforderlich: Name der Sendung.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Siehe das Beispiel Mehrere Regionen und Sprachen.
  • Pro Sprache (Land/Sprache-Paar) wird nur ein Name unterstützt.
titleEIDR Text Dringend empfohlen Warum? – Eine EIDR-ID (Entertainment Identifier Registry), die auf der allgemeinsten/abstrakten Ebene ein Werk eines Films oder Fernsehens darstellt.

So lautet beispielsweise „titleEIDR“ für die Serie „Game of Thrones“ die Nummer „10.5240/C1B5-3BA1-8991-A571-8472-W“.
potentialAction WatchAction Falls zutreffend: Ein Aktions-Markup-Objekt, das die Details der Aktion enthält.
  • Wenn die Inhalte bei Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Aktions-Markup-Objekt muss den Deeplink der Inhalte angeben.
  • Wenn die Inhalte auf einem Live-TV-Kanal verfügbar sind, ist diese Property optional. Die verknüpfte BroadcastService-Entität stellt stattdessen den Deeplink des Kanals bereit.
  • TVSeries ist sowohl für VoD als auch für Live-TV verfügbar.
Mit einem Array können Sie verschiedene Deeplinks in mehreren Regionen angeben. Siehe das Beispiel Mehrere Regionen und Sprachen.
sameAs URL Dringend empfohlen Warum? Eine URL zu einer Referenzwebseite, auf der die Sendung identifiziert werden kann, z. B. die Wikipedia-Seite der Sendung. Es muss sich von der Property url unterscheiden.
inLanguage Text Originalsprache der Reihe im BCP-47-Format.
genre Text Eine sortierte Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Suchbegriffe oder Tags, die zur Beschreibung der Inhalte verwendet werden Ein Array mit Keywords ist ebenfalls zulässig. Beispielsweise kann ["feature, bio"] ein Array von Keywords sein, um den Inhalt zu beschreiben.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Dringend empfohlen Warum?PublicationEvent wird verwendet, um die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch den Publisher anzugeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Außerdem kannst du mit FeaturedEvent angeben, dass dein Dienst diese Inhalte entweder als Original, als Spezialformat oder als Spezialmarkt vermarktet.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat und wo und wann.

Weitere Informationen und Beispiele findest du im Abschnitt „Beispiel“.
releasedEvent.@type Text Erforderlich: Legen Sie für diese Property immer eine der folgenden Optionen fest:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Regionen, die mit diesem Ereignis verknüpft sind.

Bei PublicationEvent ist dies die Region, in der die Inhalte veröffentlicht wurden.

Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der die Inhalte vorgestellt oder exklusiv sind.

Verwenden Sie ISO 3166-Codes für Länder. Um überall auf der Welt anzugeben, legen Sie EARTH fest.
releasedEvent.startDate Date oder DateTime Empfohlen: Erforderlich für ExclusiveEvent – Das Startdatum der Veröffentlichung der Entität.

Bei PublicationEvent bezeichnet dies das Veröffentlichungsdatum dieser Entität, z. B. das Datum, an dem ein Film erstmals im Kino veröffentlicht wurde.

Bei ExclusiveEvent und FeaturedEvent entspricht dies dem Startdatum des Exklusiv- oder Funktionszeitraums der Entität.
releasedEvent.endDate Date oder DateTime Empfohlen: Erforderlich für ExclusiveEvent – Gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

Für ExclusiveEvent steht das Datum, an dem die Rechte an den Inhalten ablaufen.

Wenn FeaturedEvent angezeigt wird, ist dies der Zeitpunkt, an dem der Anbieter die Entität unbegrenzt anbietet.

Wenn die Inhalte auf Dauer oder exklusiv verfügbar sind, setze endDate auf 20 Jahre ab dem aktuellen Datum.
releasedEvent.publishedBy Organisation oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Dringend empfohlen Warum? Zusammenfassung der Sendung übersichtliche Zusammenfassungen vorzuziehen. Max. 300 Zeichen.
actor Person oder PerformingGroup oder PerformanceRole Dringend empfohlen Warum? Ein Array mit Mitwirkenden. Weitere Informationen zur Modellierung
director Person Dringend empfohlen Warum? Die Regisseure der Sendung.
producer Organisation oder Person Dringend empfohlen Warum? Produzent(en) der Sendung
image ImageObject Erforderlich für Google TV: Die Bilder, die sich auf die TV-Serie beziehen. Weitere Informationen zu den erforderlichen und optionalen Attributen für die Verwendung mit image findest du unter Bildeigenschaften.
trailer.description Text Die Beschreibung des Trailers. Siehe das Beispiel Trailer.
trailer.inLanguage Text Die Sprache des Trailers im BCP-47-Format.
trailer.url URL Eine URL eines Trailers, der öffentlich gehostet und von den jeweiligen Produktionsstudios oder autorisierten Quellen hochgeladen wurde.
trailer.regionsAllowed Ort Die Regionen, in denen die Medien zulässig sind. Wenn Sie nichts angeben, wird davon ausgegangen, dass sie überall zulässig ist. Geben Sie die Länder im ISO 3166-Format an.
identifier PropertyValue Dringend empfohlen Warum? – Externe oder andere ID, durch die diese Entität eindeutig identifiziert wird Mehrere IDs sind zulässig. Weitere Informationen finden Sie im Abschnitt Eigenschaften von Kennungen.
popularityScore Beliebtheitsspezifikation Dringend empfohlen Warum? Ein Wert, den Google zusammen mit anderen Signalen verwendet, um Medien für Nutzer zu bestimmen. Diese Bewertung stellt die Beliebtheit der Inhalte in Bezug auf andere Inhalte in Ihrem Katalog dar. Daher muss die Skala der Bewertung in allen Feeds unter allen Entitäten in Ihrem Katalog einheitlich sein. Standardmäßig ist der Beliebtheitsfaktor der Entität auf 0 gesetzt.
popularityScore.@type Text Immer auf PopularityScoreSpecification festgelegt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Region(en), in denen dieser Beliebtheitsfaktor gilt. Wenn der Beliebtheitswert weltweit anwendbar ist, legen Sie EARTH fest. Standardmäßig ist diese Property auf EARTH gesetzt.
Note: Die gebietsspezifische Beliebtheit hat Vorrang vor der globalen (EARTH) Beliebtheit
review Prüfung Sieh dir die Bewertungen für die Serie an
review.reviewRating Bewertung Erforderlich, wenn review angegeben wird: Damit wird die Bewertung angegeben, die in der Rezension angegeben wurde.
contentRating Text oder Bewertung Für nicht jugendfreie Inhalte erforderlich, andernfalls dringend empfohlen: Altersfreigabe insgesamt. Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, sind zwei Varianten zulässig:
  • Die Bewertungsstelle, der die Bewertung vorangeht, mit einem Leerzeichen dazwischen. So sollte beispielsweise die Altersfreigabe "TV-MA" von der Behörde "TVPG" in den USA den Namen "TVPG TV-MA" haben. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Altersfreigabe nicht bekannt) (Groß-/Kleinschreibung nicht berücksichtigend) bedeutet, dass Sie die Bewertung des Inhalts nicht kennen.
contentRating.author Text oder Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Einstufungsstelle. Eine Liste der akzeptierten Einstufungsagenturen finden Sie auf der Seite Inhaltseinstufungsagenturen.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Beratungscode für den Inhalt. Zulässige Werte sind D, FV, L, S und V, D = Dialog, FV = Fantasiegewalt , L = Sprache, S = pornografische Inhalte, V = Gewalt.

TVEpisode

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: immer auf ["http://schema.org", {"@language": "xx"}]
    festgelegt
  • Dabei ist xx die Sprache der Strings im Feed. Für jeden Stammentitätskontext muss „@language“ auf den entsprechenden Sprachcode im BCP-47-Format festgelegt sein. Wenn die Sprache beispielsweise Spanisch eingestellt ist, wird angenommen, dass die Namen auf Spanisch sind, auch wenn die Untertitelsprache auf Englisch ist.
@type Text Erforderlich: Immer auf TVEpisode gesetzt.
@id URL Erforderlich: Kennzeichnung des Inhalts im URI-Format, z. B. https://beispiel.de/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog
  • Die ID sollte immer gleich bleiben, auch wenn sich die URL-Property der Sendung ändert. Er wird als undurchsichtiger String behandelt und muss kein gültiger Link sein.
  • In Form von Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da der url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, den url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL des Inhalts, die Google verwendet, um den Inhalt Ihres Feeds mit den Inhalten in den Google-Datenbanken abzugleichen.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die Google crawlen kann.
Weitere Informationen zum Deeplink der Wiedergabe finden Sie stattdessen in der urlTemplate-Eigenschaft des Ziel-Objekts.
name Text Erforderlich: Name der Folge.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Siehe das Beispiel Mehrere Sprachen anzeigen.
  • Pro Sprache (Land/Sprache-Paar) wird nur ein Name unterstützt.
titleEIDR Text Dringend empfohlen Warum? – Eine EIDR-ID (Entertainment Identifier Registry), die auf der allgemeinsten/abstrakten Ebene ein Werk eines Films oder Fernsehens darstellt.

Ein Beispiel: titleEIDR für die erste Folge der ersten Staffel von „Game of Thrones“ lautet „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X“.
editEIDR Text Dringend empfohlen Warum? – Eine EIDR (Entertainment Identifier Registry), die eine bestimmte Änderung / Ausgabe für ein Werk eines Films oder einer TV-Sendung darstellt.

Die erste Folge der ersten Staffel von „Series of Thrones“ mit dem Titel „EIDR“ „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X“ hat beispielsweise einen Schnitt, z. B. „10.5240/FB97-C847-2969-CAB4EC1D1C“

Die Property titleEIDR ist erforderlich, wenn die Änderung „EIDR“ angegeben wird.
inLanguage Text Originalsprache der Reihe im BCP-47-Format.
episodeNumber Ganzzahl Erforderlich: Die Nummer, die die Position dieser Folge in der Reihenfolge der Folgen einer Staffel angibt. episodeNumber muss für jede Staffel neu gestartet werden, d. h., die erste Folge einer Staffel muss 1 sein.
partOfSeason TV-Staffel Erforderlich: Die Serienstaffel, zu der diese Folge gehört.

Auch wenn TVEpisode keine entsprechende TVSeason hat, musst du die partOfSeason.@id- und partOfSeason.seasonNumber-Properties angeben. Problemumgehung:
  • Verwenden Sie partofSeries.@id (z. B. http://www.beispiel.de/meine_Lieblingssendung_Sendung) und hängen Sie ein Platzhalter-Abfragefeld (z. B. ?Saison1) an, um eine eindeutige partOfSeason.@id zu erstellen (z. B. http://www.beispiel.de/meine_Lieblingssendung?Saison1).
  • Setzen Sie partOfSeason.seasonNumber auf 1.
partOfSeason.@type Text Erforderlich: Immer auf TVSeason gesetzt.
partOfSeason.@id URL Erforderlich: @id von TVSeason, zu der diese Folge gehört.
partOfSeason.seasonNumber Ganzzahl Erforderlich: Eine Zahl, die die Position der Staffel in der Reihenfolge der Staffeln in der Serie angibt.
partOfSeries TV-Serie Erforderlich: Die TV-Serie, zu der diese Folge gehört.
partOfSeries.@type Text Erforderlich: Immer auf TVSeries gesetzt.
partOfSeries.@id URL Erforderlich: @id von TVSeries, zu der diese Folge gehört.
partOfSeries.name Text Erforderlich: Der Name der Serie.
partOfSeries.sameAs Text Eine URL zu einer Referenzwebseite, auf der die Sendung identifiziert werden kann, z. B. die Wikipedia-Seite der Sendung. Es muss sich von der Property url unterscheiden.
potentialAction WatchAction Falls zutreffend: Ein Aktions-Markup-Objekt, das die Details der Aktion enthält.
  • Wenn die Inhalte bei Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Aktions-Markup-Objekt muss den Deeplink der Inhalte angeben.
  • Wenn die Inhalte auf einem Live-TV-Kanal verfügbar sind, ist diese Property optional. Die verknüpfte BroadcastService-Entität stellt stattdessen den Deeplink des Kanals bereit.
  • TVEpisode ist sowohl für VoD als auch für Live-TV verfügbar.
Mit einem Array können Sie verschiedene Deeplinks in mehreren Regionen angeben. Siehe das Beispiel Mehrere Regionen und Sprachen.
sameAs Dringend empfohlen Warum? URL Eine URL zu einer Referenzwebseite, auf der die Folge identifiziert werden kann. Beispiel: die Wikipedia-Seite der Folge. Es muss sich von der Property url unterscheiden.
duration Dauer Laufzeit der Folge im ISO 8601-Format. Verwenden Sie das Format „PT00H00M“.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Dringend empfohlen Warum?PublicationEvent wird verwendet, um die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch den Publisher anzugeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Außerdem kannst du mit FeaturedEvent angeben, dass dein Dienst diese Inhalte entweder als Original, als Spezialformat oder als Spezialmarkt vermarktet.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat und wo und wann.

Weitere Informationen und Beispiele findest du im Abschnitt „Beispiel“.
releasedEvent.@type Text Erforderlich: Legen Sie für diese Property immer eine der folgenden Optionen fest:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Regionen, die mit diesem Ereignis verknüpft sind.

Bei PublicationEvent ist dies die Region, in der die Inhalte veröffentlicht wurden.

Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der die Inhalte vorgestellt oder exklusiv sind.

Verwenden Sie ISO 3166-Codes für Länder. Um überall auf der Welt anzugeben, legen Sie EARTH fest.
releasedEvent.startDate Date oder DateTime Empfohlen: Erforderlich für ExclusiveEvent – Das Startdatum der Veröffentlichung der Entität.

Bei PublicationEvent bezeichnet dies das Veröffentlichungsdatum dieser Entität, z. B. das Datum, an dem ein Film erstmals im Kino veröffentlicht wurde.

Bei ExclusiveEvent und FeaturedEvent entspricht dies dem Startdatum des Exklusiv- oder Funktionszeitraums der Entität.
releasedEvent.endDate Date oder DateTime Empfohlen: Erforderlich für ExclusiveEvent – Gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

Für ExclusiveEvent steht das Datum, an dem die Rechte an den Inhalten ablaufen.

Wenn FeaturedEvent angezeigt wird, ist dies der Zeitpunkt, an dem der Anbieter die Entität unbegrenzt anbietet.

Wenn die Inhalte auf Dauer oder exklusiv verfügbar sind, setze endDate auf 20 Jahre ab dem aktuellen Datum.
releasedEvent.publishedBy Organisation oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Dringend empfohlen Warum? Zusammenfassung der Folge übersichtliche Zusammenfassungen vorzuziehen. Max. 300 Zeichen.
genre Text Eine sortierte Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Suchbegriffe oder Tags, die zur Beschreibung der Inhalte verwendet werden Ein Array mit Keywords ist ebenfalls zulässig. Beispielsweise kann ["feature, bio"] ein Array von Keywords sein, um den Inhalt zu beschreiben.
actor Person oder PerformingGroup oder PerformanceRole Dringend empfohlen Warum? Ein Array mit Mitwirkenden der Folge. Weitere Informationen zur Modellierung
director Person Dringend empfohlen Warum? Der/die Regisseur(e) der Folge.
producer Organisation oder Person Dringend empfohlen Warum? Produzent(en) der Staffel
image ImageObject Dringend empfohlen Warum? für Google TV – verschiedene Bilder im Zusammenhang mit der TV-Folge Weitere Informationen zu den erforderlichen und optionalen Attributen für die Verwendung mit image findest du unter Bildeigenschaften.
trailer.description Text Die Beschreibung des Trailers. Siehe das Beispiel Trailer.
trailer.inLanguage Text Die Sprache des Trailers im BCP-47-Format.
trailer.url URL Eine URL eines Trailers, der öffentlich gehostet und von den jeweiligen Produktionsstudios oder autorisierten Quellen hochgeladen wurde.
trailer.regionsAllowed Ort Die Regionen, in denen die Medien zulässig sind. Wenn Sie nichts angeben, wird davon ausgegangen, dass sie überall zulässig ist. Geben Sie die Länder im ISO 3166-Format an.
review Prüfung Altersfreigabe für TV-Folge ansehen
review.reviewRating Bewertung Erforderlich, wenn review angegeben wird: Damit wird die Bewertung angegeben, die in der Rezension angegeben wurde.
contentRating Text oder Bewertung Für nicht jugendfreie Inhalte erforderlich, andernfalls dringend empfohlen: Altersfreigabe insgesamt. Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, sind zwei Varianten zulässig:
  • Die Bewertungsstelle, der die Bewertung vorangeht, mit einem Leerzeichen dazwischen. So sollte beispielsweise die Altersfreigabe "TV-MA" von der Behörde "TVPG" in den USA den Namen "TVPG TV-MA" haben. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Altersfreigabe nicht bekannt) (Groß-/Kleinschreibung nicht berücksichtigend) bedeutet, dass Sie die Bewertung des Inhalts nicht kennen.
contentRating.author Text oder Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Einstufungsstelle. Eine Liste der akzeptierten Einstufungsagenturen finden Sie auf der Seite Inhaltseinstufungsagenturen.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Beratungscode für den Inhalt. Zulässige Werte sind D, FV, L, S und V, D = Dialog, FV = Fantasiegewalt , L = Sprache, S = pornografische Inhalte, V = Gewalt.
identifier PropertyValue Dringend empfohlen Warum? – Externe oder andere ID, durch die diese Entität eindeutig identifiziert wird Mehrere IDs sind zulässig. Weitere Informationen finden Sie im Abschnitt Eigenschaften von Kennungen.
popularityScore Beliebtheitsspezifikation Dringend empfohlen Warum? Ein Wert, den Google zusammen mit anderen Signalen verwendet, um Medien für Nutzer zu bestimmen. Diese Bewertung stellt die Beliebtheit der Inhalte in Bezug auf andere Inhalte in Ihrem Katalog dar. Daher muss die Skala der Bewertung in allen Feeds unter allen Entitäten in Ihrem Katalog einheitlich sein. Standardmäßig ist der Beliebtheitsfaktor der Entität auf 0 gesetzt.
popularityScore.@type Text Immer auf PopularityScoreSpecification festgelegt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Region(en), in denen dieser Beliebtheitsfaktor gilt. Wenn der Beliebtheitswert weltweit anwendbar ist, legen Sie EARTH fest. Standardmäßig ist diese Property auf EARTH gesetzt.
Note: Die gebietsspezifische Beliebtheit hat Vorrang vor der globalen (EARTH) Beliebtheit

TVSeason

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: immer auf ["http://schema.org", {"@language": "xx"}]
    festgelegt
  • Dabei ist xx die Sprache der Strings im Feed. Für jeden Stammentitätskontext muss „@language“ auf den entsprechenden Sprachcode im BCP-47-Format festgelegt sein. Wenn die Sprache beispielsweise Spanisch eingestellt ist, wird angenommen, dass die Namen auf Spanisch sind, auch wenn die Untertitelsprache auf Englisch ist.
@type Text Erforderlich: Immer auf TVSeason gesetzt.
@id URL Erforderlich: Kennzeichnung des Inhalts im URI-Format, z. B. https://beispiel.de/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog
  • Die ID sollte immer gleich bleiben, auch wenn sich die URL-Property der Sendung ändert. Er wird als undurchsichtiger String behandelt und muss kein gültiger Link sein.
  • In Form von Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da der url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, den url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL des Inhalts, die Google verwendet, um den Inhalt Ihres Feeds mit den Inhalten in den Google-Datenbanken abzugleichen.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die Google crawlen kann.
Weitere Informationen zum Deeplink der Wiedergabe finden Sie stattdessen in der urlTemplate-Eigenschaft des Ziel-Objekts.
name Text Erforderlich: Der Name dieser Staffel.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Siehe das Beispiel Mehrere Sprachen anzeigen.
  • Pro Sprache (Land/Sprache-Paar) wird nur ein Name unterstützt.
titleEIDR Text Dringend empfohlen Warum? – Eine EIDR-ID (Entertainment Identifier Registry), die auf der allgemeinsten/abstrakten Ebene ein Werk eines Films oder Fernsehens darstellt.

Ein Beispiel: „titleEIDR“ für die erste Staffel der Serie „Game of Thrones“ lautet „10.5240/FD91-C72C-4161-FCBA-058B-1“.
seasonNumber Ganzzahl Erforderlich: Eine Zahl, die die Position der Staffel in der Reihenfolge der Staffeln in der Serie angibt.
partOfSeries TV-Serie Erforderlich: Die Serie, zu der diese Staffel gehört.
partOfSeries.@type Text Erforderlich: Immer auf TVSeries gesetzt.
partOfSeries.@id URL Erforderlich: @id der TVSeries, zu der diese Staffel gehört.
partOfSeries.name Text Erforderlich: Der Name der Serie.
partOfSeries.sameAs Text Eine URL zu einer Referenzwebseite, auf der die Sendung identifiziert werden kann, z. B. die Wikipedia-Seite der Sendung. Es muss sich von der Property url unterscheiden.
potentialAction WatchAction Falls zutreffend: Ein Aktions-Markup-Objekt, das die Details der Aktion enthält.
  • Wenn die Inhalte bei Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Aktions-Markup-Objekt muss den Deeplink der Inhalte angeben.
  • Wenn die Inhalte auf einem Live-TV-Kanal verfügbar sind, ist diese Property optional. Die verknüpfte BroadcastService-Entität stellt stattdessen den Deeplink des Kanals bereit.
  • TVSeason ist sowohl für VoD als auch für Live-TV verfügbar.
Mit einem Array können Sie verschiedene Deeplinks in mehreren Regionen angeben. Siehe das Beispiel Mehrere Regionen und Sprachen.
sameAs URL Dringend empfohlen Warum? Eine URL zu einer Referenzwebseite, auf der die Staffel angegeben werden kann, z. B. die Wikipedia-Seite zur Staffel. Es muss sich von der Property url unterscheiden.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Dringend empfohlen Warum? – Mit PublicationEvent wird die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch den Publisher angegeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Mit FeaturedEvent kannst du außerdem angeben, dass dein Dienst diese Inhalte als Original, Spezialformat oder Spezialmarkt vermarktet.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat und wo und wann enthalten ist.

Weitere Informationen und Beispiele findest du im Beispielabschnitt.
releasedEvent.@type Text Erforderlich: Legen Sie für diese Property immer eine der folgenden Optionen fest:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Regionen, die mit diesem Ereignis verknüpft sind.

Bei PublicationEvent ist dies die Region, in der die Inhalte veröffentlicht wurden.

Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der die Inhalte vorgestellt oder exklusiv sind.

Verwenden Sie ISO 3166-Codes für Länder. Um überall auf der Welt anzugeben, legen Sie EARTH fest.
releasedEvent.startDate Date oder DateTime Empfohlen: Erforderlich für ExclusiveEvent – Das Startdatum der Veröffentlichung der Entität.

Bei PublicationEvent bezeichnet dies das Veröffentlichungsdatum dieser Entität, z. B. das Datum, an dem ein Film erstmals im Kino veröffentlicht wurde.

Bei ExclusiveEvent und FeaturedEvent entspricht dies dem Startdatum des Exklusiv- oder Funktionszeitraums der Entität.
releasedEvent.endDate Date oder DateTime Empfohlen: Erforderlich für ExclusiveEvent – Gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

Für ExclusiveEvent steht das Datum, an dem die Rechte an den Inhalten ablaufen.

Wenn FeaturedEvent angezeigt wird, ist dies der Zeitpunkt, an dem der Anbieter die Entität unbegrenzt anbietet.

Wenn die Inhalte auf Dauer oder exklusiv verfügbar sind, setze endDate auf 20 Jahre ab dem aktuellen Datum.
releasedEvent.publishedBy Organisation oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Dringend empfohlen Warum? Zusammenfassung der Saison übersichtliche Zusammenfassungen vorzuziehen. Max. 300 Zeichen.
actor [Person, PerformingGroup oder PerformanceRole Dringend empfohlen Warum? Ein Array mit Mitwirkenden der Saison. Weitere Informationen zur Modellierung
director Person Dringend empfohlen Warum? Ein Array der Regisseure der Sendung.
producer Organisation oder Person Dringend empfohlen Warum? Produzent(en) der Staffel
image ImageObject Bilder, die zur TVSeason passen Weitere Informationen zu den erforderlichen und optionalen Attributen für die Verwendung mit image findest du unter Bildeigenschaften.
genre Text Eine sortierte Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Suchbegriffe oder Tags, die zur Beschreibung der Inhalte verwendet werden Ein Array mit Keywords ist ebenfalls zulässig. Beispielsweise kann ["feature, bio"] ein Array von Keywords sein, um den Inhalt zu beschreiben.
trailer.description Text Die Beschreibung des Trailers. Siehe das Beispiel Trailer.
trailer.inLanguage Text Die Sprache des Trailers im BCP-47-Format.
trailer.url URL Eine URL eines Trailers, der öffentlich gehostet und von den jeweiligen Produktionsstudios oder autorisierten Quellen hochgeladen wurde.
trailer.regionsAllowed Ort Die Regionen, in denen die Medien zulässig sind. Wenn Sie nichts angeben, wird davon ausgegangen, dass sie überall zulässig ist. Geben Sie die Länder im ISO 3166-Format an.
identifier PropertyValue Dringend empfohlen Warum? – Externe oder andere ID, durch die diese Entität eindeutig identifiziert wird Mehrere IDs sind zulässig. Weitere Informationen finden Sie im Abschnitt Eigenschaften von Kennungen.
popularityScore Beliebtheitsspezifikation Dringend empfohlen Warum? Ein Wert, den Google zusammen mit anderen Signalen verwendet, um Medien für Nutzer zu bestimmen. Diese Bewertung stellt die Beliebtheit der Inhalte in Bezug auf andere Inhalte in Ihrem Katalog dar. Daher muss die Skala der Bewertung in allen Feeds unter allen Entitäten in Ihrem Katalog einheitlich sein. Standardmäßig ist der Beliebtheitsfaktor der Entität auf 0 gesetzt.
popularityScore.@type Text Immer auf PopularityScoreSpecification festgelegt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Region(en), in denen dieser Beliebtheitsfaktor gilt. Wenn der Beliebtheitswert weltweit anwendbar ist, legen Sie EARTH fest. Standardmäßig ist diese Property auf EARTH gesetzt.
Note: Die gebietsspezifische Beliebtheit hat Vorrang vor der globalen (EARTH) Beliebtheit
review Prüfung Altersfreigabe für TV-Staffel überprüfen
review.reviewRating Bewertung Erforderlich, wenn review angegeben wird: Damit wird die Bewertung angegeben, die in der Rezension angegeben wurde.
contentRating Text oder Bewertung Für nicht jugendfreie Inhalte erforderlich, andernfalls dringend empfohlen: Altersfreigabe insgesamt. Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, sind zwei Varianten zulässig:
  • Die Bewertungsstelle, der die Bewertung vorangeht, mit einem Leerzeichen dazwischen. So sollte beispielsweise die Altersfreigabe "TV-MA" von der Behörde "TVPG" in den USA den Namen "TVPG TV-MA" haben. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Altersfreigabe nicht bekannt) (Groß-/Kleinschreibung nicht berücksichtigend) bedeutet, dass Sie die Bewertung des Inhalts nicht kennen.
contentRating.author Text oder Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Einstufungsstelle. Eine Liste der akzeptierten Einstufungsagenturen finden Sie auf der Seite Inhaltseinstufungsagenturen.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Beratungscode für den Inhalt. Zulässige Werte sind D, FV, L, S und V, D = Dialog, FV = Fantasiegewalt , L = Sprache, S = pornografische Inhalte, V = Gewalt.

Spezifikationen des Akteurs

Mit dem Attribut actor in den Entitätstypen TVSeries, TVEpisode und TVSeason kannst du weitere Details zu den Akteuren angeben, z. B. den Namen ihrer Figuren und die Rollen, die sie in der TV-Sendung spielen. Nachfolgend finden Sie einige Beispiele dafür.

Attribut Erwarteter Typ Beschreibung
actor Person oder PerformingGroup oder PerformanceRole Dringend empfohlen Warum? : Ein Array der Mitwirkenden.
  • Verwenden Sie den Typ PerformanceRole, wenn die Rolle gespielt wurde, und optional den Namen des Mitwirkenden. In diesem Fall ist der Akteur Person oder PerformingGroup in das Objekt PerformanceRole eingebettet.
  • Mit dem Typ Person geben Sie die einzelnen Akteuren oder die Gruppe PerformingGroup an, um Details zu den Mitwirkenden anzugeben, wenn die von den Mitwirkenden gespielten Rollen unbekannt sind.

Verwenden Sie ein Array, um mehrere Personen, PerformingGroups oder PerformanceRoles darzustellen.

Die Typen Person oder PerformingGroup verwenden

Geben Sie die folgenden Properties an, wenn der Typ Person oder PerformingGroup verwendet wird

Attribut Erwarteter Typ Beschreibung
@type Person oder PerformingGroup Erforderlich: immer auf Person oder PerformingGroup festgelegt.
@id URL Dringend empfohlen Warum? – Die Nutzer oder die Gruppen-ID im URI-Format, z. B. https://beispiel.de/actor/abc. @id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog pro Schauspieler/Gruppe
  • Die ID sollte immer gleich bleiben. Er wird als undurchsichtiger String behandelt und muss kein gültiger Link sein.
  • In Form von Unified Resource Identifier (URI)
  • Ihre Organisation muss die für den @id-Wert verwendete Domain sein.

Die in der Eigenschaft „actor“ verwendete @id sollte im Feed einheitlich verwendet werden. Wenn beispielsweise zwei Filme denselben Schauspieler haben, sollte der Wert @id für diese beiden Schauspielerobjekte beibehalten werden.

name Text Erforderlich: Name des Schauspielers/der Schauspielerin/des Darstellers/der Schauspielergruppe.
sameAs URL Dringend empfohlen Warum? – Eine URL zu einer Referenzwebseite, auf der der Akteur oder die darstellende Gruppe identifiziert werden kann, z. B. die Wikipedia-Seite des Akteurs. Es muss sich von der Property @id unterscheiden.

Den Typ PerformanceRole verwenden

Geben Sie die folgenden Properties an, wenn der Typ PerformanceRole verwendet wird

Attribut Erwarteter Typ Beschreibung
@type PerformanceRole Erforderlich: immer auf PerformanceRole festgelegt.
roleName Text Dringend empfohlen Warum? – Eine Rolle, die vom Mitwirkenden übertragen, ausgeführt oder übernommen wird Hier finden Sie eine Liste der zulässigen Werte.
characterName Text Der Name einer Figur, die in einer Neben- oder Darstellerrolle spielt. Legen Sie dieses Feld nicht fest, wenn der Akteurtyp PerformingGroup ist.
actor Person oder PerformingGroup Erforderlich
  • Mitwirkende des Inhalts, wenn der Datentyp Person verwendet wird
  • Die Gruppe(n)/Band/en der Leistung des Inhalts, wenn der Datentyp PerformingGroup verwendet wird.
actor.@type Person oder PerformingGroup Erforderlich: immer auf Person oder PerformingGroup festgelegt.
actor.@id URL Dringend empfohlen Warum? – Die ID des Akteurs oder der Künstlergruppe im URI-Format, z. B. https://beispiel.de/actor/abc. @id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog pro Schauspieler/Gruppe
  • Die ID sollte immer gleich bleiben. Er wird als undurchsichtiger String behandelt und muss kein gültiger Link sein.
  • In Form von Unified Resource Identifier (URI)
  • Ihre Organisation muss die für den @id-Wert verwendete Domain sein.

Die in der Eigenschaft „actor“ verwendete @id sollte im Feed einheitlich verwendet werden. Wenn beispielsweise zwei Filme denselben Schauspieler haben, sollte der Wert @id für diese beiden Schauspielerobjekte beibehalten werden.

actor.name Text Erforderlich: Name des Schauspielers/der Schauspielerin/des Darstellers/der Schauspielergruppe.
actor.sameAs URL Dringend empfohlen Warum? – Eine URL zu einer Referenzwebseite, auf der der Akteur oder die darstellende Gruppe identifiziert werden kann, z. B. die Wikipedia-Seite des Akteurs. Diese muss sich von der Property „actor.@id“ unterscheiden.

Zulässige Rollennamen

Für diese Werte muss die actor.@type auf Person gesetzt werden.

roleName Wert Beschreibung
„Cameo“ Ein Cameo-Auftritt, auch Cameo-Auftritt genannt, ist eine kurze Darstellung einer bekannten Person in einem Werk der darstellenden Künste.
„VoiceActor“ Bei einer Sprechstimme wird die Stimme des Schauspielers verwendet, er erscheint jedoch nicht auf dem Bildschirm. Dies wird meistens in der Animation genannt, erscheint aber auch, wenn die Stimme eines Schauspielers in die Stimme eines anderen Schauspielers synchronisiert wird.
„Doppelt“ Ein Doppelperson ist eine Person, die einen anderen Schauspieler ersetzt, sodass das Gesicht der Person nicht zu sehen ist.
„MotionCaptureActor“ Ein MotionCaptureActor bezieht sich auf eine Person, die Aktionen von menschlichen Darstellern aufzeichnet und anhand dieser Informationen Animationen für digitale Charaktermodelle in 2D- oder 3D-Computeranimationen erstellt.

Diese Werte werden in der Regel für die Typen Person und PerformingGroup akzeptiert.

roleName Wert Beschreibung
„Akteur“ Ein Schauspieler ist eine Person, die eine Figur in einem traditionellen Medium des Theaters oder in modernen Medien wie Film, Radio und Fernsehen darstellt.
„GastStar“ „Ein Gaststar ist ein Schauspieler, der eine fiktive Rolle spielt und in einer oder mehreren Folgen erscheint. Es kann vorkommen, dass ein Gaststar eine wichtige wiederkehrende Figur spielt und mehrmals in einer Serie erscheint, obwohl er kein Mitglied der Hauptbesetzung ist. Legen Sie einen Wert auf „GuestStar“ fest, wenn die Besetzung eine Gastauftritte hat oder ein Gast der Show ist. Gaststars sollten nur auf der Ebene der Folge und nicht auf der Ebene der TV-Serie hinzugefügt werden.
„Gast“ „Ein Gast in einer Talkshow. Hinweis: „GuestStar“ ist zwar eine fiktionale Rolle, „Gast“ ist jedoch ein fiktiver Fall.
„Sprecherin“ Ein Kündiger ist eine Person, die Eröffnungs- und Abschlussbücher für die Show bereitstellt, die Moderatoren, die Teilnehmer und/oder Prominentengäste vorstellt, die verfügbaren Preise beschreibt und die Zuhörer vor der Aufnahme warm und aufgelockt.
„Kommentator“ Bei einem Kommentar kann ein Spiel oder eine Veranstaltung in Echtzeit gemeldet werden, in der Regel während einer Liveübertragung.
„Impressionsist“ Ein Impressionist oder Nachahmung ist ein Künstler, dessen Akteur sich auf die Nachahmung von Klängen, Stimmen und Tonalitäten von Prominenten und Zeichentrickfiguren bezieht.
„Organisator“ Eine Person, die Fernsehprogramme einführt, präsentiert oder hostet. Sie dient häufig als Vermittler für das Programm und die Zuhörer. Der „Host“ ist in der Regel eine Sachbücher.
„CoHost“ Eine Person, die ein Ereignis oder ein Programm gemeinsam mit einer anderen Person organisiert.
„GuestHost“ Ein Gasthost ist ein Gastgeber, normalerweise einer Talkshow, der das Programm statt des regulären Organisators hostet, wenn kein Host verfügbar ist.
„Nachrichtensender“ Eine Person, die die Öffentlichkeit über Nachrichten und Ereignisse auf lokaler, nationaler und internationaler Ebene in einem Fernsehnachrichtenprogramm präsentiert und informiert.
„Korrespondenz“ Der Reporter oder Journalist ist normalerweise Journalist oder Kommentator einer Zeitschrift oder Vertreter einer Zeitung, Radio- oder Fernsehnachrichten oder einer anderen Unternehmensform von einem fernen, oft weit entfernten Standort aus.
„ShowJudge“ Ein Jurist ist eine Person, die oft als Experte auf dem Gebiet der Show betrachtet wird, und erhält die Rolle eines "Juroren", der aus Kritikern herauskommt und für den Wettbewerb der TV-Serie teilnimmt.
„Panelmitglied“ Mitglied eines Diskussions- oder Beratungsgremiums eines Radio- oder Fernsehbereichs
„Protestant“ Ein Teilnehmer in einem Wettbewerb oder einer Spielshow ist eine Person, die an diesem Wettbewerb teilnimmt.
„StoryNarrator“ Der Sprecher erzählt etwas, vor allem eine Figur, die die Geschichten eines Romans oder Erzählbuchs erzählt.
„MusicalArtist“ „Ein Musiker kann eine Person oder Gruppe oder ein fiktiver Charakter sein, der in der Regel regelmäßig vor einem Publikum auftritt oder Musikstücke oder Alben aufgenommen hat. Komponisten und Texter sollten diesen Typ nur dann verwenden, wenn die Nennungen einiger musikalischer Werke auch bedeuten, dass sie als Hauptkünstler beitragen. Dieser Typ kann verwendet werden, um permanente Musiker- oder Musikergruppen sowie Gastmusiker oder Musikergruppen mit Shows zu verknüpfen.

Es wird zwischen einer Hauptrolle und einer Hauptrolle eines Schauspielers unterschieden.

Um zwischen den Haupt- und normalen Schauspielern sowie den Gast- und Hauptdarstellern einer TV-Sendung zu unterscheiden, fügen Sie das Hauptdarsteller nur in TVSeries-Entitäten hinzu und fügen Sie nur den Gastcast oder den Cast für unterstützende Rollen für die TVEpisode-Entitäten hinzu. Achte darauf, dass die Haupt- und normale Umwandlung nicht zu TVEpisode hinzugefügt wird.

Beispiele

Beispiel für TVSeries, TVEpisode und TVSeason

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Beispiele für Actor-Properties

Die Rolle des Akteurs ist unbekannt

Wenn die Rolle eines Akteurs unbekannt ist, empfehlen wir, die Informationen zum Akteur über den Typ Person oder PerformingGroup anzugeben.

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

Die Rolle des Akteurs ist bekannt

Wenn die Rolle eines Akteurs bekannt ist, empfehlen wir, ihm die entsprechenden Informationen bereitzustellen. Verwenden Sie dazu den Typ 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"
      }
  }
]

Bekannte Rollen für eine Teilmenge von Akteuren

Wenn die Metadaten der Leistungsrolle nicht bekannt sind, empfehlen wir, die Akteurinformationen entweder über den Typ Person oder PerformingGroup anzugeben. Für den Fall, dass diese Informationen bekannt sind, verwenden Sie den Typ PerformanceRole . Diese Typen können im selben Array gemeinsam hinzugefügt werden.

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

Auf den folgenden Seiten finden Sie die Themen für diese Properties: