Eigenschaften von Inhalts-Markup von TV-Sendungen

In diesem Abschnitt finden Sie Details zu den Inhalts-Markup-Properties für die Entitätstypen TVSeries, TVEpisode und TVSeason.

Die Angabe von TVSeason als vollständige Entität ist optional. Weitere Informationen finden Sie im Abschnitt Beziehungen „TVSeries“, „TVSeason“ und „TVEpisode“.

Tabelle mit Spezifikationen

TVSeries

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Muss immer auf ["http://schema.org", {"@language": "xx"}]
gesetzt sein.
  • Dabei steht „xx“ für die Sprache der Strings im Feed. Für jeden Stammentitätskontext sollte @language auf den entsprechenden Sprachcode im BCP 47-Format festgelegt sein. Wenn die Sprache beispielsweise auf Spanisch eingestellt ist, wird davon ausgegangen, dass die Namen auf Spanisch sind, auch wenn die Sprache der Untertitel oder Synchronisation Englisch ist.
@type Text Erforderlich: Muss immer auf TVSeries gesetzt sein.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Sie muss in Ihrem gesamten Katalog eindeutig sein.
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Uniform Resource Identifiers (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL der Inhalte, anhand derer Google die Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken abgleicht.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die von Google gecrawlt werden kann.
Den Deeplink für die Wiedergabe findest du stattdessen im Attribut urlTemplate des Ziel-Objekts.
name Text Erforderlich: Der Name der Sendung.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Siehe Beispiel Mehrere Regionen und Sprachen.
  • Pro Sprache und Land wird nur ein Name unterstützt.
titleEIDR Text Empfohlen Warum? – Eine EIDR-ID (Entertainment Identifier Registry), die auf der allgemeinsten/abstraktesten Ebene ein Film- oder Fernsehwerk darstellt.

Die „titleEIDR“ für die TV-Serie „Game of Thrones“ lautet beispielsweise „10.5240/C1B5-3BA1-8991-A571-8472-W“.
potentialAction WatchAction Falls zutreffend erforderlich: Ein Aktions-Markup-Objekt mit den Details der Aktion.
  • Wenn die Inhalte als Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Action-Markup-Objekt muss den Deeplink zu den Inhalten enthalten.
  • Wenn die Inhalte auf einem LiveTV-Kanal verfügbar sind, ist diese Eigenschaft optional. Der Deeplink des Kanals wird stattdessen von der zugehörigen BroadcastService-Entität bereitgestellt.
  • Ein TVSeries kann sowohl bei VoD als auch bei Live-TV verfügbar sein.
Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Siehe Beispiel Mehrere Regionen und Sprachen.
sameAs URL Empfohlen Warum? Die URL einer Referenzwebseite, anhand derer die Sendung identifiziert werden kann, z. B. die Wikipedia-Seite der Sendung. Dieser 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 Keywords oder Tags, die diese Inhalte beschreiben. Auch ein Array von Keywords ist zulässig. [„feature, biography“] kann beispielsweise ein Array von Keywords sein, um die Inhalte zu beschreiben.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Empfohlen Warum? – Mit PublicationEvent wird die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch einen Publisher angegeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Verwende außerdem FeaturedEvent, um anzugeben, dass dein Dienst diese Inhalte als Original, als empfohlen, als Sonderangebot usw. bewirbt.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Angaben zu Ort und Zeitpunkt.

Details und Beispiele findest du im Beispielbereich.
releasedEvent.@type Text Erforderlich: Diese Eigenschaft muss immer auf eine der folgenden Optionen festgelegt werden:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Die Regionen, die mit diesem Ereignis verknüpft sind.

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

Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der die Inhalte präsentiert oder exklusiv verfügbar sind.

Verwende ISO 3166-Codes für Länder. Wenn Sie alle Regionen der Welt einbeziehen möchten, geben Sie EARTH ein.
releasedEvent.startDate Datum oder DateTime Empfohlen – Erforderlich für ExclusiveEvent: Das Startdatum der Veröffentlichung der Entität.

Bei einer PublicationEvent gibt dies das Datum der Erstveröffentlichung dieser Entität an, z. B. das Datum, an dem ein Film erstmals in den Kinos gezeigt wurde.

Bei ExclusiveEvent und FeaturedEvent ist dies das Startdatum, ab dem die Entität exklusiv oder als „Empfohlen“ gekennzeichnet ist.
releasedEvent.endDate Datum oder DateTime Empfohlen – Erforderlich für ExclusiveEvent – Diese Angabe gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

Bei ExclusiveEvent ist dies das Datum, an dem die Rechte an den Inhalten ablaufen.

Bei FeaturedEvent ist dies das letzte Datum, an dem der Anbieter das Rechtssubjekt präsentiert.

Wenn die Inhalte zeitlich unbegrenzt exklusiv oder vorgestellt werden, legen Sie endDate auf 20 Jahre ab dem aktuellen Datum fest.
releasedEvent.publishedBy Organisation oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Empfohlen Warum? Eine Zusammenfassung der Sendung. Plot-Synopsen werden Sachzusammenfassungen vorgezogen. Die maximale Zeichenanzahl beträgt 300.
actor Person oder PerformingGroup oder PerformanceRole Empfohlen Warum? Ein Array mit den Darstellern der Serie. Weitere Informationen zur Modellierung
director Person Empfohlen Warum? Die Regisseure der Sendung.
producer Organisation oder Person Empfohlen Warum? Die Produzenten 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 Properties, die Sie in image einschließen sollten, finden Sie unter Bild-Properties.
trailer.description Text Die Beschreibung des Trailers. Trailer
trailer.inLanguage Text Die Sprache des Trailers im BCP 47-Format.
trailer.url URL Die 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 keine Region angegeben wird, wird davon ausgegangen, dass das Video überall zulässig ist. Gib die Länder im ISO 3166-Format an.
identifier PropertyValue Empfohlen Warum? – Externe oder sonstige ID, durch die diese Entität eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt ID-Attribute.
popularityScore PopularityScoreSpecification Empfohlen Warum? Ein Wert, der zusammen mit anderen Signalen von Google verwendet wird, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Vergleich zu anderen Inhalten in deinem Katalog an. Daher muss die Skala für die Bewertung in allen Feeds und für alle Entitäten in deinem Katalog einheitlich sein. Standardmäßig ist der Beliebtheitswert einer Entität auf 0 gesetzt.
popularityScore.@type Text Immer auf PopularityScoreSpecification gesetzt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit des Elements angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Regionen, in denen dieser Beliebtheitsrang gilt. Wenn der Beliebtheitsfaktor global gilt, legen Sie EARTH fest. Standardmäßig ist diese Eigenschaft auf EARTH eingestellt.
Note: Die landesspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH)
review Rezension Altersfreigaben für die TV-Serie überprüfen
review.reviewRating Bewertung Erforderlich, wenn review angegeben ist Hiermit wird die in der Rezension angegebene Bewertung angegeben.
contentRating Text oder Altersfreigabe Erforderlich für Inhalte nur für Erwachsene, ansonsten dringend empfohlen: Gesamte Inhaltseinstufung. Wenn die Altersfreigabe in Form eines Textstrings angegeben ist, sind zwei Varianten zulässig:
  • Die Ratingagentur hat der Bewertung ein Leerzeichen vorangestellt. Beispiel: Eine Altersfreigabe „TV-MA“ der US-amerikanischen Agentur „TVPG“ sollte als „TVPG TV-MA“ beschrieben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (RATING NICHT BESTIMMT) gibt an, dass die Altersfreigabe für die Inhalte nicht bekannt ist.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Altersfreigabestelle. Eine Liste der akzeptierten Altersfreigabestellen finden Sie auf der Seite Altersfreigabestellen.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Altersfreigabe.
contentRating.advisoryCode Text Der Hinweiscode für die Inhalte. Zulässige Werte sind D, FV, L, S und V. D = Dialog, FV = Fantasy Violence, L = Language, S = Sexual Content, V = Violence.

TVEpisode

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Muss immer auf ["http://schema.org", {"@language": "xx"}]
gesetzt sein.
  • Dabei steht „xx“ für die Sprache der Strings im Feed. Für jeden Stammentitätskontext sollte @language auf den entsprechenden Sprachcode im BCP 47-Format festgelegt sein. Wenn die Sprache beispielsweise auf Spanisch eingestellt ist, wird davon ausgegangen, dass die Namen auf Spanisch sind, auch wenn die Sprache der Untertitel oder Synchronisation Englisch ist.
@type Text Erforderlich: Muss immer auf TVEpisode gesetzt sein.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Sie muss in Ihrem gesamten Katalog eindeutig sein.
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Uniform Resource Identifiers (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL der Inhalte, mit der Google die Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken abgleicht.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die von Google gecrawlt werden kann.
Den Deeplink für die Wiedergabe findest du stattdessen im Attribut urlTemplate des Ziel-Objekts.
name Text Erforderlich: Der Name der Folge.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Weitere Informationen finden Sie im Beispiel Mehrsprachige Darstellung.
  • Pro Sprache und Land wird nur ein Name unterstützt.
titleEIDR Text Empfohlen Warum? – Eine EIDR (Entertainment Identifier Registry), die auf der allgemeinsten/abstraktesten Ebene ein Film- oder Fernsehwerk darstellt.

Die „titleEIDR“ für die erste Folge der ersten Staffel der TV-Serie „Game of Thrones“ lautet beispielsweise „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X“.
editEIDR Text Empfohlen Warum? – Eine EIDR (Entertainment Identifier Registry), die eine bestimmte Fassung eines Films oder einer Fernsehsendung darstellt.

Die erste Folge der ersten Staffel der TV-Serie „Game of Thrones“, deren TitleEIDR „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X“ lautet, hat eine Änderung, z.B. „10.5240/FB97-C847-2969-D0AB-ECD1-C“. Die Property

titleEIDR ist erforderlich, wenn „editEIDR“ angegeben wird.
inLanguage Text Originalsprache der Reihe im BCP 47-Format.
episodeNumber Ganzzahl Erforderlich: Die Nummer gibt die Position dieser Folge in der Reihenfolge der Folgen in einer Staffel an. episodeNumber muss für jede Staffel neu gestartet werden. Die erste Folge jeder Staffel muss also 1 sein.
partOfSeason TVSeason Erforderlich: Die Staffel der Serie, zu der diese Folge gehört.

Auch wenn eine TVEpisode keine entsprechende TVSeason hat, müssen die Properties partOfSeason.@id und partOfSeason.seasonNumber angegeben werden. Eine Problemumgehung:
  • Fügen Sie der partofSeries.@id (z. B. http://www.beispiel.de/meine_lieblingsserie) ein Platzhalter-Suchfeld hinzu (z. B. ?staffel1), um eine eindeutige partOfSeason.@id zu erstellen (z. B. http://www.beispiel.de/meine_lieblingsserie?staffel1).
  • Setzen Sie partOfSeason.seasonNumber auf 1.
partOfSeason.@type Text Erforderlich: Muss immer auf TVSeason gesetzt sein.
partOfSeason.@id URL Erforderlich: Die @id der TVSeason, zu der diese Folge gehört.
partOfSeason.seasonNumber Ganzzahl Erforderlich: Die Zahl gibt die Position dieser Staffel in der Reihenfolge der Staffeln in der Fernsehserie an.
partOfSeries TVSeries Erforderlich: Die TV-Serie, zu der diese Folge gehört.
partOfSeries.@type Text Erforderlich: Muss immer auf TVSeries gesetzt sein.
partOfSeries.@id URL Erforderlich: Die @id der TVSeries, zu der diese Folge gehört.
partOfSeries.name Text Erforderlich: Der Name der TV-Serie.
partOfSeries.sameAs Text Die URL einer Referenzwebseite, anhand derer die Sendung identifiziert werden kann, z. B. die Wikipedia-Seite der Sendung. Dieser muss sich von der Property url unterscheiden.
potentialAction WatchAction Falls zutreffend erforderlich: Ein Aktions-Markup-Objekt mit den Details der Aktion.
  • Wenn die Inhalte als Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Action-Markup-Objekt muss den Deeplink zu den Inhalten enthalten.
  • Wenn die Inhalte auf einem LiveTV-Kanal verfügbar sind, ist diese Eigenschaft optional. Der Deeplink des Kanals wird stattdessen von der zugehörigen BroadcastService-Entität bereitgestellt.
  • Ein TVEpisode kann sowohl bei VoD als auch bei Live-TV verfügbar sein.
Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Siehe Beispiel Mehrere Regionen und Sprachen.
sameAs Empfohlen Warum? URL Die URL einer Referenzwebseite, anhand derer die Folge identifiziert werden kann, z. B. die Wikipedia-Seite der Folge. Dieser 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 Empfohlen Warum? – Mit PublicationEvent wird die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch einen Verlag oder Webpublisher angegeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Verwende außerdem FeaturedEvent, um anzugeben, dass dein Dienst diese Inhalte als Original, als empfohlen, als Sonderangebot usw. bewirbt.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Angaben zu Ort und Zeitpunkt.

Details und Beispiele findest du im Beispielbereich.
releasedEvent.@type Text Erforderlich: Diese Eigenschaft muss immer auf eine der folgenden Optionen festgelegt werden:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Die Regionen, die mit diesem Ereignis verknüpft sind.

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

Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der die Inhalte präsentiert oder exklusiv verfügbar sind.

Verwende ISO 3166-Codes für Länder. Wenn Sie alle Regionen der Welt einbeziehen möchten, geben Sie EARTH ein.
releasedEvent.startDate Datum oder DateTime Empfohlen – Erforderlich für ExclusiveEvent: Das Startdatum der Veröffentlichung der Entität.

Bei einer PublicationEvent gibt dies das Datum der Erstveröffentlichung dieser Entität an, z. B. das Datum, an dem ein Film erstmals in den Kinos gezeigt wurde.

Bei ExclusiveEvent und FeaturedEvent ist dies das Startdatum, ab dem die Entität exklusiv oder als „Empfohlen“ gekennzeichnet ist.
releasedEvent.endDate Datum oder DateTime Empfohlen – Erforderlich für ExclusiveEvent – Diese Angabe gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

Bei ExclusiveEvent ist dies das Datum, an dem die Rechte an den Inhalten ablaufen.

Bei FeaturedEvent ist dies das letzte Datum, an dem der Anbieter das Rechtssubjekt präsentiert.

Wenn die Inhalte zeitlich unbegrenzt exklusiv oder vorgestellt werden, legen Sie endDate auf 20 Jahre ab dem aktuellen Datum fest.
releasedEvent.publishedBy Organisation oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Empfohlen Warum? Eine Zusammenfassung der Folge. Plot-Synopsen werden Sachzusammenfassungen vorgezogen. Die maximale Zeichenanzahl beträgt 300.
  • Verwenden Sie ein Array, um die Beschreibung in mehreren Sprachen zu markieren. Weitere Informationen finden Sie im Beispiel Mehrsprachige Darstellung.
genre Text Eine sortierte Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Keywords oder Tags, die diese Inhalte beschreiben. Auch ein Array von Keywords ist zulässig. [„feature, biography“] kann beispielsweise ein Array von Keywords sein, um die Inhalte zu beschreiben.
actor Person oder PerformingGroup oder PerformanceRole Empfohlen Warum? Ein Array mit den Darstellern der Folge. Weitere Informationen zur Modellierung
director Person Empfohlen Warum? Die Regisseure der Folge.
producer Organisation oder Person Empfohlen Warum? Die Produzenten der Staffel.
image ImageObject Empfohlen Warum? für Google TV: Verschiedene Bilder, die sich auf die TV-Folge beziehen. Weitere Informationen zu den erforderlichen und optionalen Properties, die Sie in image einschließen sollten, finden Sie unter Bild-Properties.
trailer.description Text Die Beschreibung des Trailers. 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 keine Region angegeben wird, wird davon ausgegangen, dass das Video überall zulässig ist. Gib die Länder im ISO 3166-Format an.
review Rezension Altersfreigaben für die TV-Folge überprüfen
review.reviewRating Bewertung Erforderlich, wenn review angegeben ist Hiermit wird die in der Rezension angegebene Bewertung angegeben.
contentRating Text oder Altersfreigabe Erforderlich für Inhalte nur für Erwachsene, ansonsten dringend empfohlen: Gesamte Inhaltseinstufung. Wenn die Altersfreigabe in Form eines Textstrings angegeben ist, sind zwei Varianten zulässig:
  • Die Ratingagentur hat der Bewertung ein Leerzeichen vorangestellt. Beispiel: Eine Altersfreigabe „TV-MA“ der US-amerikanischen Agentur „TVPG“ sollte als „TVPG TV-MA“ beschrieben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (RATING NICHT BESTIMMT) gibt an, dass die Altersfreigabe für die Inhalte nicht bekannt ist.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Altersfreigabestelle. Eine Liste der akzeptierten Altersfreigabestellen finden Sie auf der Seite Altersfreigabestellen.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Altersfreigabe.
contentRating.advisoryCode Text Der Hinweiscode für die Inhalte. Zulässige Werte sind D, FV, L, S und V. D = Dialog, FV = Fantasy Violence, L = Language, S = Sexual Content, V = Violence.
identifier PropertyValue Empfohlen Warum? – Externe oder sonstige ID, durch die diese Entität eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt ID-Attribute.
popularityScore PopularityScoreSpecification Empfohlen Warum? Ein Wert, der zusammen mit anderen Signalen von Google verwendet wird, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Vergleich zu anderen Inhalten in deinem Katalog an. Daher muss die Skala für die Bewertung in deinen Feeds und für alle Entitäten in deinem Katalog einheitlich sein. Standardmäßig ist der Beliebtheitswert einer Entität auf 0 gesetzt.
popularityScore.@type Text Immer auf PopularityScoreSpecification gesetzt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit des Elements angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Regionen, in denen dieser Beliebtheitsrang gilt. Wenn der Beliebtheitsfaktor global gilt, legen Sie EARTH fest. Standardmäßig ist diese Eigenschaft auf EARTH eingestellt.
Note: Die länderspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH)

TVSeason

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Muss immer auf ["http://schema.org", {"@language": "xx"}]
gesetzt sein.
  • Dabei steht „xx“ für die Sprache der Strings im Feed. Für jeden Stammentitätskontext sollte @language auf den entsprechenden Sprachcode im BCP 47-Format festgelegt sein. Wenn die Sprache beispielsweise auf Spanisch eingestellt ist, wird davon ausgegangen, dass die Namen auf Spanisch sind, auch wenn die Sprache der Untertitel oder Synchronisation Englisch ist.
@type Text Erforderlich: Muss immer auf TVSeason gesetzt sein.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Sie muss in Ihrem gesamten Katalog eindeutig sein.
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Uniform Resource Identifiers (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL der Inhalte, anhand derer Google die Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken abgleicht.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die von Google gecrawlt werden kann.
Den Deeplink für die Wiedergabe findest du stattdessen im Attribut urlTemplate des Ziel-Objekts.
name Text Erforderlich: Der Name dieser TV-Staffel.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Weitere Informationen finden Sie im Beispiel Mehrsprachige Darstellung.
  • Pro Sprache und Land wird nur ein Name unterstützt.
titleEIDR Text Empfohlen Warum? – Eine EIDR-ID (Entertainment Identifier Registry), die auf der allgemeinsten/abstraktesten Ebene ein Film- oder Fernsehwerk darstellt.

Die „titleEIDR“ für die erste Staffel der TV-Serie „Game of Thrones“ lautet beispielsweise „10.5240/FD91-C72C-4161-FCBA-058B-1“.
seasonNumber Ganzzahl Erforderlich: Die Zahl gibt die Position dieser Staffel in der Reihenfolge der Staffeln in der Fernsehserie an.
partOfSeries TVSeries Erforderlich: Die TV-Serie, zu der diese Staffel gehört.
partOfSeries.@type Text Erforderlich: Muss immer auf TVSeries gesetzt sein.
partOfSeries.@id URL Erforderlich: Die @id der TVSeries, zu der diese Staffel gehört.
partOfSeries.name Text Erforderlich: Der Name der TV-Serie.
partOfSeries.sameAs Text Die URL einer Referenzwebseite, anhand derer die Sendung identifiziert werden kann, z. B. die Wikipedia-Seite der Sendung. Dieser muss sich von der Property url unterscheiden.
potentialAction WatchAction Falls zutreffend erforderlich: Ein Aktions-Markup-Objekt mit den Details der Aktion.
  • Wenn die Inhalte als Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Action-Markup-Objekt muss den Deeplink zu den Inhalten enthalten.
  • Wenn die Inhalte auf einem LiveTV-Kanal verfügbar sind, ist diese Eigenschaft optional. Der Deeplink des Kanals wird stattdessen von der zugehörigen BroadcastService-Entität bereitgestellt.
  • Ein TVSeason kann sowohl bei VoD als auch bei Live-TV verfügbar sein.
Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Siehe Beispiel Mehrere Regionen und Sprachen.
sameAs URL Empfohlen Warum? Die URL einer Referenzwebseite, anhand derer die Saison identifiziert werden kann, z. B. die Wikipedia-Seite der Saison. Dieser muss sich von der Property url unterscheiden.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Empfohlen Warum? – Mit PublicationEvent wird die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch einen Verlag oder Webpublisher angegeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Verwende außerdem FeaturedEvent, um anzugeben, dass dein Dienst diese Inhalte als Original, als vorgestellte Inhalte, als Sonderangebot usw. bewirbt.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Angaben zu Ort und Zeitpunkt.

Details und Beispiele findest du im Beispielbereich.
releasedEvent.@type Text Erforderlich: Diese Eigenschaft muss immer auf eine der folgenden Optionen festgelegt sein:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Die Regionen, die mit diesem Ereignis verknüpft sind.

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

Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der die Inhalte präsentiert oder exklusiv verfügbar sind.

Verwende ISO 3166-Codes für Länder. Wenn Sie alle Regionen der Welt einbeziehen möchten, geben Sie EARTH ein.
releasedEvent.startDate Datum oder DateTime Empfohlen – Erforderlich für ExclusiveEvent: Das Startdatum der Veröffentlichung der Entität.

Bei einer PublicationEvent gibt dies das Datum der Erstveröffentlichung dieser Entität an, z. B. das Datum, an dem ein Film erstmals in den Kinos gezeigt wurde.

Bei ExclusiveEvent und FeaturedEvent ist dies das Startdatum, ab dem die Entität exklusiv oder als „Empfohlen“ gekennzeichnet ist.
releasedEvent.endDate Datum oder DateTime Empfohlen – Erforderlich für ExclusiveEvent – Diese Angabe gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

Bei ExclusiveEvent ist dies das Datum, an dem die Rechte an den Inhalten ablaufen.

Bei FeaturedEvent ist dies das letzte Datum, an dem der Anbieter das Rechtssubjekt präsentiert.

Wenn die Inhalte dauerhaft exklusiv oder vorgestellt werden, legen Sie endDate auf 20 Jahre ab dem aktuellen Datum fest.
releasedEvent.publishedBy Organisation oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Empfohlen Warum? Eine Zusammenfassung der Staffel. Plot-Synopsen werden Sachzusammenfassungen vorgezogen. Die maximale Zeichenanzahl beträgt 300.
  • Verwenden Sie ein Array, um die Beschreibung in mehreren Sprachen zu markieren. Weitere Informationen finden Sie im Beispiel Mehrsprachige Darstellung.
actor [Person oder PerformingGroup oder PerformanceRole Empfohlen Warum? Ein Array der Darsteller der Staffel. Weitere Informationen zur Modellierung
director Person Empfohlen Warum? Ein Array der Regisseure der Serie.
producer Organisation oder Person Empfohlen Warum? Die Produzenten der Staffel.
image ImageObject Die Bilder, die sich auf die TV-Saison beziehen. Weitere Informationen zu den erforderlichen und optionalen Properties, die Sie in image einschließen sollten, finden Sie unter Bild-Properties.
genre Text Eine sortierte Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Keywords oder Tags, die diese Inhalte beschreiben. Auch ein Array von Keywords ist zulässig. [„feature, biography“] kann beispielsweise ein Array von Keywords sein, um die Inhalte zu beschreiben.
trailer.description Text Die Beschreibung des Trailers. Trailer
trailer.inLanguage Text Die Sprache des Trailers im BCP 47-Format.
trailer.url URL Die 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 keine Region angegeben wird, wird davon ausgegangen, dass das Video überall zulässig ist. Gib die Länder im ISO 3166-Format an.
identifier PropertyValue Empfohlen Warum? – Externe oder sonstige ID, durch die diese Entität eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt ID-Attribute.
popularityScore PopularityScoreSpecification Empfohlen Warum? Ein Wert, der zusammen mit anderen Signalen von Google verwendet wird, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Vergleich zu anderen Inhalten in deinem Katalog an. Daher muss die Skala für die Bewertung in allen Feeds und für alle Entitäten in deinem Katalog einheitlich sein. Standardmäßig ist der Beliebtheitswert einer Entität auf 0 gesetzt.
popularityScore.@type Text Immer auf PopularityScoreSpecification gesetzt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit des Elements angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Regionen, in denen dieser Beliebtheitsrang gilt. Wenn der Beliebtheitsfaktor global gilt, legen Sie EARTH fest. Standardmäßig ist diese Eigenschaft auf EARTH eingestellt.
Note: Die länderspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH)
review Rezension Bewertungen für die TV-Saison überprüfen
review.reviewRating Bewertung Erforderlich, wenn review angegeben ist Hiermit wird die in der Rezension angegebene Bewertung angegeben.
contentRating Text oder Altersfreigabe Erforderlich für Inhalte nur für Erwachsene, ansonsten dringend empfohlen: Gesamte Inhaltseinstufung. Wenn die Altersfreigabe in Form eines Textstrings angegeben ist, sind zwei Varianten zulässig:
  • Die Ratingagentur hat der Bewertung ein Leerzeichen vorangestellt. Beispiel: Eine Altersfreigabe „TV-MA“ der US-amerikanischen Agentur „TVPG“ sollte als „TVPG TV-MA“ beschrieben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (NICHT KENNTN) gibt an, dass die Altersfreigabe für die Inhalte nicht bekannt ist.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Altersfreigabestelle. Eine Liste der akzeptierten Altersfreigabestellen finden Sie auf der Seite Altersfreigabestellen.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Altersfreigabe.
contentRating.advisoryCode Text Der Hinweiscode für die Inhalte. Zulässige Werte sind D, FV, L, S und V. D = Dialog, FV = Fantasy Violence, L = Language, S = Sexual Content, V = Violence.

Spezifikationen für Akteure

Mit dem Attribut actor in den Entitätstypen TVSeries, TVEpisode und TVSeason kannst du weitere Details zu den Schauspielern angeben, einschließlich der Namen ihrer Charaktere und der Rollen, die sie in der Fernsehsendung spielen. In den folgenden Abschnitten werden diese Funktionen beschrieben, zusammen mit einigen Beispielen zur Veranschaulichung der Verwendung.

Attribut Erwarteter Typ Beschreibung
actor Person oder PerformingGroup oder PerformanceRole Empfohlen Warum? : Ein Array der Darsteller.
  • Verwenden Sie den Typ PerformanceRole, wenn die Rolle und (optional) der Charaktername der Darsteller bekannt sind. In diesem Fall ist die Rolle Person oder PerformingGroup in das Objekt PerformanceRole eingebettet.
  • Verwende den Typ Person, um die einzelnen Schauspieler anzugeben, oder PerformingGroup, um Details zu den ausführenden Gruppen/Bands anzugeben, wenn die Rolle(n) der Darsteller unbekannt sind.

Verwende ein Array, um mehrere Personen, Künstlergruppen oder Rollen darzustellen.

Person- oder PerformingGroup-Typen verwenden

Gib die folgenden Properties an, wenn der Typ Person oder PerformingGroup verwendet wird.

Attribut Erwarteter Typ Beschreibung
@type Person oder PerformingGroup Erforderlich: Muss immer auf Person oder PerformingGroup gesetzt sein.
@id URL Empfohlen Warum? – Die Kennung der Darsteller oder der ausführenden Gruppe im URI-Format, z. B. https://beispiel.de/darsteller/abc. @id müssen die folgenden Anforderungen erfüllen:
  • Global eindeutig für den gesamten Katalog pro Darsteller/Aufführungsgruppe
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Uniform Resource Identifiers (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.

Die in der Property „actor“ verwendete @id muss im gesamten Feed einheitlich verwendet werden. Wenn es beispielsweise zwei Filme mit demselben Schauspieler gibt, sollte der Wert für @id für diese beiden Schauspielerobjekte gleich bleiben.

name Text Erforderlich: Der Name des Schauspielers, der Schauspielerin, des Darstellers oder der Gruppe.
sameAs URL Empfohlen Warum? – Eine URL zu einer Referenzwebseite, über die sich der Darsteller oder die ausführende Gruppe identifizieren lässt, z. B. die Wikipedia-Seite des Darstellers. Dieser muss sich von der Property @id unterscheiden.

PerformanceRole-Typ verwenden

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

Attribut Erwarteter Typ Beschreibung
@type PerformanceRole Erforderlich: Muss immer auf PerformanceRole gesetzt sein.
roleName Text Empfohlen Warum? – Eine Rolle, die das Darstellermitglied spielt, ausführt oder innehat. Hier finden Sie eine Liste der zulässigen Werte.
characterName Text Der Name einer Figur, die in einer Schauspiel- oder darstellenden Rolle gespielt wird. Legen Sie dieses Feld nicht fest, wenn der Akteurtyp PerformingGroup ist.
actor Person oder PerformingGroup Erforderlich :
  • Die Darsteller der Inhalte, wenn der Datentyp Person verwendet wird.
  • Die ausführenden Gruppen/Bands der Inhalte, wenn der Datentyp PerformingGroup verwendet wird.
actor.@type Person oder PerformingGroup Erforderlich: Muss immer auf Person oder PerformingGroup gesetzt sein.
actor.@id URL Empfohlen Warum? – Die Kennzeichnung des Akteurs oder der ausführenden Gruppe im URI-Format, z. B. https://beispiel.de/actor/abc. @id müssen die folgenden Anforderungen erfüllen:
  • Global eindeutig für den gesamten Katalog pro Darsteller/Aufführungsgruppe
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Uniform Resource Identifiers (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.

Die in der Property „actor“ verwendete @id muss im gesamten Feed einheitlich verwendet werden. Wenn es beispielsweise zwei Filme mit demselben Schauspieler gibt, sollte der Wert für @id für diese beiden Schauspielerobjekte gleich bleiben.

actor.name Text Erforderlich: Der Name des Schauspielers, der Schauspielerin, des Darstellers oder der Gruppe.
actor.sameAs URL Empfohlen Warum? – Eine URL zu einer Referenzwebseite, über die sich der Darsteller oder die ausführende Gruppe identifizieren lässt, z. B. die Wikipedia-Seite des Darstellers. Diese muss sich von der Property „actor.@id“ unterscheiden.

Zulässige Rollennamen

Für diese Werte muss actor.@type = Person sein.

roleName Wert Beschreibung
„Cameo“ Eine Cameo-Rolle ist ein kurzer Auftritt einer bekannten Person in einem Werk der darstellenden Künste.
„VoiceActor“ Bei einer Synchronstimme wird die Stimme des Schauspielers verwendet, aber er ist nicht auf dem Bildschirm zu sehen. Dies ist am häufigsten bei Animationen zu sehen, kann aber auch vorkommen, wenn die Stimme eines Schauspielers über die eines anderen Schauspielers gelegt wird.
„Doppelt“ Ein Double 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 die Aktionen von menschlichen Schauspielern aufzeichnet und diese Informationen verwendet, um digitale Charaktermodelle in 2D- oder 3D-Computeranimationen zu animieren.

Diese Werte sind für die Typen Person und PerformingGroup allgemein zulässig.

roleName Wert Beschreibung
„Darsteller“ Ein Schauspieler oder eine Schauspielerin ist eine Person, die eine Figur in einer Aufführung im 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 wenigen Folgen auftritt. In einigen Fällen spielt ein Gaststar eine wichtige wiederkehrende Rolle und tritt in einer Serie mehrmals auf, obwohl er nicht zum Hauptdarsteller gehört. Lege den Wert auf „Gaststar“ fest, wenn die Besetzung eine Gastrolle hat oder Gast in der Sendung ist. Gaststars sollten nur auf Folgenebene angegeben und nicht auf Serienebene hinzugefügt werden.
„Gast“ „Ein Gast in einer Talkshow. Hinweis: „Gaststar“ ist eine fiktive Rolle, „Gast“ eine nicht fiktive Rolle.
„Sprecher“ Ein Moderator ist eine Person, die die Eröffnungs- und Schlussworte für die Sendung spricht, den Moderator, die Teilnehmer und/oder prominenten Gäste vorstellt, die verfügbaren Preise beschreibt und das Publikum vor der Aufzeichnung aufwärmt und während der Pausen bei Laune hält.
„Kommentator“ Ein Kommentator kommentiert ein Spiel oder eine Veranstaltung in Echtzeit, in der Regel während einer Liveübertragung.
„Impressionist“ Ein Imitator ist ein Künstler, der Geräusche, Stimmen und Verhaltensweisen von Prominenten und Cartoonfiguren nachahmt.
„Host“ Eine Person, die Fernsehsendungen einführt, präsentiert oder moderiert und oft als Vermittler zwischen dem Programm und dem Publikum fungiert. Die Rolle „Moderator“ ist in der Regel eine Rolle aus dem Bereich Nonfiction.
„CoHost“ Eine Person, die eine Veranstaltung/ein Programm gemeinsam mit anderen Personen organisiert.
„GuestHost“ Ein Gastmoderator ist ein Moderator, in der Regel einer Talkshow, der das Programm anstelle des regulären Moderators moderiert, wenn dieser nicht verfügbar ist.
„Nachrichtensprecher“ Eine Person, die die Öffentlichkeit über Nachrichten und Ereignisse auf lokaler, nationaler und internationaler Ebene in einem Nachrichtenprogramm im Fernsehen informiert.
„Korrespondent“ Ein Korrespondent oder Reporter vor Ort ist in der Regel ein Journalist oder Kommentator für ein Magazin oder ein Agent, der Berichte für eine Zeitung, Radio- oder Fernsehnachrichten oder ein anderes Unternehmen von einem entfernten, oft weit entfernten Ort aus verfasst.
„ShowJudge“ Eine Jury ist eine Person, die oft als Experte auf dem Gebiet der Sendung gilt und die Rolle des „Jurors“ übernimmt, um die Teilnehmer zu kritisieren, die sich für die TV-Serie bewerben und an dem Wettbewerb teilnehmen.
„Panelmitglied“ Ein Mitglied einer Diskussionsrunde oder eines Beratungsgremiums eines Radio- oder Fernsehpanels.
„Teilnehmer“ Ein Teilnehmer an einem Wettbewerb oder einer Spielshow ist eine Person, die daran teilnimmt.
„StoryNarrator“ Ein Erzähler ist eine Person, die etwas erzählt, insbesondere eine Figur, die die Ereignisse eines Romans oder eines erzählenden Gedichts wiedergibt.
„MusicalArtist“ „Ein Musiker kann eine Person, eine Gruppe oder eine fiktive Figur sein, die regelmäßig vor Publikum aufgetreten ist oder Musiktitel oder Musikalben aufgenommen hat. Komponisten und Texter sollten nur diesen Typ haben, wenn die Mitwirkenden bei einem bestimmten Musikwerk angeben, dass sie auch als Hauptdarsteller mitwirken. Mit diesem Typ kannst du Serien feste Musiker oder Musikergruppen sowie Gastmusiker oder Gastmusikergruppen zuordnen.

Zwischen einer Haupt- und einer Nebenrolle eines Schauspielers unterscheiden

Wenn du zwischen den Haupt-/Stamm- und Gast-/Nebendarstellern in einer TV-Sendung unterscheiden möchtest, füge die Hauptdarsteller nur den TVSeries-Entitäten hinzu und nur die Gastdarsteller oder Darsteller mit Nebenrollen den TVEpisode-Entitäten. Die Haupt-/Regulären Darsteller dürfen den TVEpisode-Entitäten nicht hinzugefügt werden.

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

Rolle des Akteurs ist unbekannt

Wenn die Rolle eines Darstellers nicht bekannt ist, empfehlen wir, die Informationen zum Darsteller entweder mit dem 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"
    }
  ]

Rolle des Akteurs ist bekannt

Wenn die Rolle eines Schauspielers bekannt ist, empfehlen wir, die Informationen zum Schauspieler mit dem Typ PerformanceRole anzugeben.

"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 der Schauspieler

Wenn keine Metadaten zur Rolle der Darsteller bekannt sind, empfehlen wir, die Informationen zum Darsteller entweder mit dem Typ Person oder PerformingGroup anzugeben. Wenn diese Informationen bekannt sind, verwenden Sie den Datentyp PerformanceRole . Diese Typen können in dasselbe Array eingefü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 Informationen zu diesen Properties: