Eigenschaften von Inhalts-Markup von TV-Sendungen

In diesem Abschnitt finden Sie die Details der 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 zwischen TVSeries, TVSeason und TVEpisode.

Spezifikationstabelle

TVSeries

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Immer auf ["http://schema.org", {"@language": "xx"}]
    gesetzt.
  • Dabei steht „xx“ für die Sprache der Strings im Feed. Für jeden Kontext der Stamm-Entität 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 Untertitel-/Synchronisationssprache Englisch ist.
@type Text Erforderlich: Immer auf TVSeries gesetzt.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Serie ändert. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL des Inhalts, die Google verwendet, um die Inhalte in Ihrem Feed 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 von Google gecrawlt werden kann.
Den Deeplink für die Wiedergabe finden Sie stattdessen im Attribut urlTemplate des Objekts target.
name Text Erforderlich: Der Name der Serie.
titleEIDR Text Sehr empfehlenswert Warum? – Eine EIDR-ID (Entertainment Identifier Registry), die auf der allgemeinsten/abstraktesten Ebene ein Film- oder Fernsehwerk darstellt.

Die EIDR für die TV-Serie „Game of Thrones“ lautet beispielsweise „10.5240/C1B5-3BA1-8991-A571-8472-W“.
potentialAction WatchAction Bei Bedarf erforderlich: Ein Action-Markup-Objekt, das die Details der Aktion enthält.
  • Wenn die Inhalte als Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Action-Markup-Objekt muss den Deeplink der Inhalte enthalten.
  • Wenn die Inhalte auf einem Live-TV-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 in VoD als auch im Live-TV verfügbar sein.
Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Beispiel für mehrere Regionen und Sprachen
sameAs URL Sehr empfehlenswert Warum? Eine URL zu einer Referenzwebseite, auf der die Serie identifiziert werden kann, z. B. die Wikipedia-Seite der Serie. Muss sich von der Property url unterscheiden.
inLanguage Text Sehr empfehlenswert: Originalsprache der Serie im BCP 47-Format.
genre Text Eine sortierte Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Keywords oder Tags, die zur Beschreibung dieses Inhalts verwendet werden. Ein Array von Keywords ist ebenfalls zulässig. Beispielsweise kann [„feature, biography“] ein Array von Keywords sein, um den Inhalt zu beschreiben.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Sehr empfehlenswert 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, Featured, Special usw. vermarktet.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Angaben dazu, wo und wann.

Weitere Informationen und Beispiele findest du im Beispielabschnitt.
releasedEvent.@type Text Erforderlich: Legen Sie für dieses Attribut immer einen der folgenden Werte fest:
  • 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 werden oder exklusiv sind.

Verwenden Sie ISO 3166-Codes für Länder. Legen Sie EARTH fest, um alle Orte weltweit anzugeben.
releasedEvent.startDate Date oder DateTime Empfohlen – Erforderlich für ExclusiveEvent: Das Startdatum der Veröffentlichung der Entität.

Bei einem PublicationEvent ist dies das ursprüngliche Veröffentlichungsdatum der Entität, z. B. das Datum, an dem ein Film zum ersten Mal in den Kinos veröffentlicht wurde.

Bei ExclusiveEvent und FeaturedEvent ist dies das Startdatum, ab dem die Entität exklusiv oder beworben wird.
releasedEvent.endDate Date oder DateTime Empfohlen – Erforderlich für ExclusiveEvent – Dies gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

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

Für FeaturedEvent steht dies für das letzte Datum, an dem der Anbieter das Rechtssubjekt präsentiert.

Wenn die Inhalte dauerhaft exklusiv sind oder präsentiert werden, legen Sie endDate auf 20 Jahre ab dem aktuellen Datum fest.
releasedEvent.publishedBy Organization oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Sehr empfehlenswert Warum? Eine Zusammenfassung der Serie. Handlungszusammenfassungen werden gegenüber sachlichen Zusammenfassungen bevorzugt. Max. 300 Zeichen.
actor Person oder PerformingGroup oder PerformanceRole Sehr empfehlenswert Warum? Ein Array der Darsteller der Serie. Weitere Informationen
director Person Sehr empfehlenswert Warum? Der Regisseur oder die Regisseure der Serie.
producer Organization oder Person Sehr empfehlenswert Warum? Die Produzenten der Show.
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 mit image einfügen müssen, finden Sie unter Bild-Properties.
trailer.description Text Die Beschreibung des Trailers. Beispiel für einen Trailer
trailer.inLanguage Text Sehr empfohlen: Die Sprache des Trailers im BCP 47-Format.
trailer.url URL Eine URL eines öffentlich gehosteten Trailers, der 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, geht Google davon aus, dass das Video überall zulässig ist. Gib die Länder im ISO 3166-Format an.
identifier PropertyValue Sehr empfehlenswert Warum? – Externe oder sonstige ID, durch die diese Einheit eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt Identifier properties (Kennzeichnerattribute).
popularityScore PopularityScoreSpecification Sehr empfehlenswert Warum? Eine Punktzahl, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Verhältnis zu anderen Inhalten in Ihrem Katalog an. Daher muss die Skala des Werts in allen Feeds und für alle Elemente in Ihrem Katalog einheitlich sein. Standardmäßig ist die Beliebtheitsbewertung einer Entität auf 0 festgelegt.
popularityScore.@type Text Immer auf PopularityScoreSpecification gesetzt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Einheit angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Region(en), für die dieser Beliebtheitswert gilt. Wenn der Beliebtheitswert global anwendbar ist, legen Sie ihn auf EARTH fest. Standardmäßig ist dieses Attribut auf EARTH gesetzt.
Note: Länderspezifische Beliebtheit hat Vorrang vor globaler (EARTH) Beliebtheit
review Rezension Bewertungen für die Serie ansehen
review.reviewRating Bewertung Erforderlich, wenn review angegeben ist. Damit wird die in der Rezension abgegebene Bewertung angegeben.
contentRating Text oder Altersfreigabe Erforderlich für Inhalte für Erwachsene, ansonsten dringend empfohlen: Gesamteinstufung der Inhalte. Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, sind zwei Varianten zulässig:
  • Die Ratingagentur wird dem Rating mit einem Leerzeichen vorangestellt. Beispiel: Die Altersfreigabe „TV-MA“ der Agentur „TVPG“ in den USA sollte als „TVPG TV-MA“ angegeben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Groß-/Kleinschreibung wird nicht berücksichtigt) gibt an, dass Sie die Altersfreigabe für die Inhalte nicht kennen.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Ratingagentur. Eine Liste der akzeptierten Einstufungsstellen finden Sie auf der Seite Einstufungsstellen.
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 (Gewalt in der Fantasie), L = Language (Sprache), S = Sexual Content (Sexuelle Inhalte), V = Violence (Gewalt).

TVEpisode

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Immer auf ["http://schema.org", {"@language": "xx"}]
    gesetzt.
  • Dabei steht „xx“ für die Sprache der Strings im Feed. Für jeden Kontext der Stamm-Entität 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 Untertitel-/Synchronisationssprache Englisch ist.
@type Text Erforderlich: Immer auf TVEpisode gesetzt.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Serie ändert. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL des Inhalts, die Google verwendet, um die Inhalte in Ihrem Feed 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 von Google gecrawlt werden kann.
Den Deeplink für die Wiedergabe finden Sie stattdessen im Attribut urlTemplate des Objekts target.
name Text Erforderlich: Der Name der Folge.
titleEIDR Text Sehr empfehlenswert Warum? – Eine EIDR-ID (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 Sehr empfehlenswert Warum? – Eine EIDR-Kennung (Entertainment Identifier Registry), die eine bestimmte Bearbeitung / Ausgabe eines Film- oder Fernsehwerks darstellt.

Die erste Folge der ersten Staffel der TV-Serie „Game of Thrones“ mit der EIDR-Titel-ID „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X“ hat beispielsweise eine Bearbeitung mit der EIDR-Bearbeitungs-ID „10.5240/FB97-C847-2969-D0AB-ECD1-C“. Die Property

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

Auch wenn eine TVEpisode keine entsprechende TVSeason hat, müssen Sie die Properties partOfSeason.@id und partOfSeason.seasonNumber angeben. Problemumgehung:
  • Nehmen Sie partofSeries.@id (z. B. http://www.beispiel.de/meine_lieblingsfernsehserie) und hängen Sie ein Platzhalter-Anfragefeld (z. B. ?staffel1) an, um eine eindeutige partOfSeason.@id (z. B. http://www.beispiel.de/meine_lieblingsfernsehserie?staffel1) zu erstellen.
  • Setzen Sie partOfSeason.seasonNumber auf 1.
partOfSeason.@type Text Erforderlich: Immer auf TVSeason gesetzt.
partOfSeason.@id URL Erforderlich: Die @id der TVSeason, zu der diese Folge gehört.
partOfSeason.seasonNumber Ganzzahl Erforderlich: Die Nummer, die die Position dieser Staffel in der Reihenfolge der Staffeln in der Serie angibt.
partOfSeries TVSeries Erforderlich: Die Serie, zu der diese Folge gehört.
partOfSeries.@type Text Erforderlich: Immer auf TVSeries gesetzt.
partOfSeries.@id URL Erforderlich: Die @id der 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 Serie identifiziert werden kann, z. B. die Wikipedia-Seite der Serie. Muss sich von der Property url unterscheiden.
potentialAction WatchAction Bei Bedarf erforderlich: Ein Action-Markup-Objekt, das die Details der Aktion enthält.
  • Wenn die Inhalte als Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Action-Markup-Objekt muss den Deeplink der Inhalte enthalten.
  • Wenn die Inhalte auf einem Live-TV-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 für VoD als auch für Live-TV verfügbar sein.
Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Beispiel für mehrere Regionen und Sprachen
sameAs Sehr empfehlenswert Warum? URL Eine URL zu einer Referenzwebseite, auf der die Folge identifiziert werden kann, z. B. die Wikipedia-Seite der Folge. 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 Sehr empfehlenswert 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, Empfehlung, Special usw. vermarktet.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Angaben dazu, wo und wann.

Weitere Informationen und Beispiele findest du im Beispielabschnitt.
releasedEvent.@type Text Erforderlich: Legen Sie für dieses Attribut immer einen der folgenden Werte fest:
  • 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 werden oder exklusiv sind.

Verwenden Sie ISO 3166-Codes für Länder. Legen Sie EARTH fest, um alle Orte weltweit anzugeben.
releasedEvent.startDate Date oder DateTime Empfohlen – Erforderlich für ExclusiveEvent: Das Startdatum der Veröffentlichung der Entität.

Bei einem PublicationEvent ist dies das ursprüngliche Veröffentlichungsdatum der Entität, z. B. das Datum, an dem ein Film zum ersten Mal in den Kinos veröffentlicht wurde.

Bei ExclusiveEvent und FeaturedEvent ist dies das Startdatum, ab dem die Entität exklusiv oder beworben wird.
releasedEvent.endDate Date oder DateTime Empfohlen – Erforderlich für ExclusiveEvent – Dies gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

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

Für FeaturedEvent steht dies für das letzte Datum, an dem der Anbieter das Rechtssubjekt präsentiert.

Wenn die Inhalte dauerhaft exklusiv sind oder präsentiert werden, legen Sie endDate auf 20 Jahre ab dem aktuellen Datum fest.
releasedEvent.publishedBy Organization oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Sehr empfehlenswert Warum? Eine Zusammenfassung der Folge Handlungszusammenfassungen werden gegenüber sachlichen Zusammenfassungen bevorzugt. Max. 300 Zeichen.
genre Text Eine sortierte Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Keywords oder Tags, die zur Beschreibung dieses Inhalts verwendet werden. Ein Array von Keywords ist ebenfalls zulässig. Beispielsweise kann [„feature, biography“] ein Array von Keywords sein, um den Inhalt zu beschreiben.
actor Person oder PerformingGroup oder PerformanceRole Sehr empfehlenswert Warum? Ein Array mit den Darstellern der Folge. Weitere Informationen
director Person Sehr empfehlenswert Warum? Der Regisseur oder die Regisseure der Folge.
producer Organization oder Person Sehr empfehlenswert Warum? Die Produzenten der Staffel.
image ImageObject Sehr empfehlenswert Warum? für Google TV: Verschiedene Bilder zur TV-Folge. Weitere Informationen zu den erforderlichen und optionalen Properties, die Sie mit image einfügen müssen, finden Sie unter Bild-Properties.
trailer.description Text Die Beschreibung des Trailers. Beispiel für einen Trailer
trailer.inLanguage Text Sehr empfohlen: Die Sprache des Trailers im BCP 47-Format.
trailer.url URL Eine URL eines öffentlich gehosteten Trailers, der 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, geht Google davon aus, dass das Video überall zulässig ist. Gib die Länder im ISO 3166-Format an.
review Rezension Bewertungen für die TV-Folge ansehen
review.reviewRating Bewertung Erforderlich, wenn review angegeben ist. Damit wird die in der Rezension abgegebene Bewertung angegeben.
contentRating Text oder Altersfreigabe Erforderlich für Inhalte für Erwachsene, ansonsten dringend empfohlen: Gesamteinstufung der Inhalte. Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, sind zwei Varianten zulässig:
  • Die Ratingagentur wird dem Rating mit einem Leerzeichen vorangestellt. Beispiel: Die Altersfreigabe „TV-MA“ der Agentur „TVPG“ in den USA sollte als „TVPG TV-MA“ angegeben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Groß-/Kleinschreibung wird nicht berücksichtigt) gibt an, dass Sie die Altersfreigabe für die Inhalte nicht kennen.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Ratingagentur. Eine Liste der akzeptierten Einstufungsstellen finden Sie auf der Seite Einstufungsstellen.
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 (Gewalt in der Fantasie), L = Language (Sprache), S = Sexual Content (Sexuelle Inhalte), V = Violence (Gewalt).
identifier PropertyValue Sehr empfehlenswert Warum? – Externe oder sonstige ID, durch die diese Einheit eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt Identifier properties (Kennzeichnerattribute).
popularityScore PopularityScoreSpecification Sehr empfehlenswert Warum? Eine Punktzahl, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Verhältnis zu anderen Inhalten in Ihrem Katalog an. Daher muss die Skala des Werts in allen Feeds und für alle Elemente in Ihrem Katalog einheitlich sein. Standardmäßig ist die Beliebtheitsbewertung einer Entität auf 0 festgelegt.
popularityScore.@type Text Immer auf PopularityScoreSpecification gesetzt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Einheit angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Region(en), für die dieser Beliebtheitswert gilt. Wenn der Beliebtheitswert global anwendbar ist, legen Sie ihn auf EARTH fest. Standardmäßig ist dieses Attribut auf EARTH gesetzt.
Note: Länderspezifische Beliebtheit hat Vorrang vor globaler (EARTH) Beliebtheit

TVSeason

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Immer auf ["http://schema.org", {"@language": "xx"}]
    gesetzt.
  • Dabei steht „xx“ für die Sprache der Strings im Feed. Für jeden Kontext der Stamm-Entität 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 Untertitel-/Synchronisationssprache Englisch ist.
@type Text Erforderlich: Immer auf TVSeason gesetzt.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Serie ändert. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
url URL Erforderlich: Die kanonische URL des Inhalts, die Google verwendet, um die Inhalte in Ihrem Feed 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 von Google gecrawlt werden kann.
Den Deeplink für die Wiedergabe finden Sie stattdessen im Attribut urlTemplate des Objekts target.
name Text Erforderlich: Der Name dieser Serienstaffel.
titleEIDR Text Sehr empfehlenswert Warum? – Eine EIDR-ID (Entertainment Identifier Registry), die auf der allgemeinsten/abstraktesten Ebene ein Film- oder Fernsehwerk darstellt.

Der 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 Nummer, die die Position dieser Staffel in der Reihenfolge der Staffeln in der Serie angibt.
partOfSeries TVSeries Erforderlich: Die Serie, zu der diese Staffel gehört.
partOfSeries.@type Text Erforderlich: Immer auf TVSeries gesetzt.
partOfSeries.@id URL Erforderlich: Die @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 Serie identifiziert werden kann, z. B. die Wikipedia-Seite der Serie. Muss sich von der Property url unterscheiden.
potentialAction WatchAction Bei Bedarf erforderlich: Ein Action-Markup-Objekt, das die Details der Aktion enthält.
  • Wenn die Inhalte als Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Action-Markup-Objekt muss den Deeplink der Inhalte enthalten.
  • Wenn die Inhalte auf einem Live-TV-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 für VoD als auch für Live-TV verfügbar sein.
Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Beispiel für mehrere Regionen und Sprachen
sameAs URL Sehr empfehlenswert Warum? Eine URL zu einer Referenzwebseite, auf der die Staffel identifiziert werden kann, z. B. die Wikipedia-Seite der Staffel. Muss sich von der Property url unterscheiden.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Sehr empfehlenswert 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, Featured, Special usw. vermarktet.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Angaben dazu, wo und wann.

Weitere Informationen und Beispiele findest du im Beispielabschnitt.
releasedEvent.@type Text Erforderlich: Legen Sie für dieses Attribut immer einen der folgenden Werte fest:
  • 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 werden oder exklusiv sind.

Verwenden Sie ISO 3166-Codes für Länder. Legen Sie EARTH fest, um alle Orte weltweit anzugeben.
releasedEvent.startDate Date oder DateTime Empfohlen – Erforderlich für ExclusiveEvent: Das Startdatum der Veröffentlichung der Entität.

Bei einem PublicationEvent ist dies das ursprüngliche Veröffentlichungsdatum der Entität, z. B. das Datum, an dem ein Film zum ersten Mal in den Kinos veröffentlicht wurde.

Bei ExclusiveEvent und FeaturedEvent ist dies das Startdatum, ab dem die Entität exklusiv oder beworben wird.
releasedEvent.endDate Date oder DateTime Empfohlen – Erforderlich für ExclusiveEvent – Dies gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

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

Für FeaturedEvent steht dies für das letzte Datum, an dem der Anbieter das Rechtssubjekt präsentiert.

Wenn die Inhalte dauerhaft exklusiv sind oder präsentiert werden, legen Sie endDate auf 20 Jahre ab dem aktuellen Datum fest.
releasedEvent.publishedBy Organization oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Sehr empfehlenswert Warum? Eine Zusammenfassung der Staffel. Handlungszusammenfassungen werden gegenüber sachlichen Zusammenfassungen bevorzugt. Max. 300 Zeichen.
actor [Person oder PerformingGroup oder PerformanceRole Sehr empfehlenswert Warum? Ein Array der Darsteller der Staffel. Weitere Informationen
director Person Sehr empfehlenswert Warum? Ein Array der Regisseure der Show.
producer Organization oder Person Sehr empfehlenswert Warum? Die Produzenten der Staffel.
image ImageObject Die Bilder, die mit der TVSeason verknüpft sind. Weitere Informationen zu den erforderlichen und optionalen Properties, die Sie mit image einfügen müssen, finden Sie unter Bild-Properties.
genre Text Eine sortierte Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Keywords oder Tags, die zur Beschreibung dieses Inhalts verwendet werden. Ein Array von Keywords ist ebenfalls zulässig. Beispielsweise kann [„feature, biography“] ein Array von Keywords sein, um den Inhalt zu beschreiben.
trailer.description Text Die Beschreibung des Trailers. Beispiel für einen Trailer
trailer.inLanguage Text Sehr empfohlen: Die Sprache des Trailers im BCP 47-Format.
trailer.url URL Eine URL eines öffentlich gehosteten Trailers, der 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, geht Google davon aus, dass das Video überall zulässig ist. Gib die Länder im ISO 3166-Format an.
identifier PropertyValue Sehr empfehlenswert Warum? – Externe oder sonstige ID, durch die diese Einheit eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt Identifier properties (Kennzeichnerattribute).
popularityScore PopularityScoreSpecification Sehr empfehlenswert Warum? Eine Punktzahl, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Verhältnis zu anderen Inhalten in Ihrem Katalog an. Daher muss die Skala des Werts in allen Feeds und für alle Elemente in Ihrem Katalog einheitlich sein. Standardmäßig ist die Beliebtheitsbewertung einer Entität auf 0 festgelegt.
popularityScore.@type Text Immer auf PopularityScoreSpecification gesetzt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Einheit angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Region(en), für die dieser Beliebtheitswert gilt. Wenn der Beliebtheitswert global anwendbar ist, legen Sie ihn auf EARTH fest. Standardmäßig ist dieses Attribut auf EARTH gesetzt.
Note: Länderspezifische Beliebtheit hat Vorrang vor globaler (EARTH) Beliebtheit
review Rezension Bewertungen für die TV-Staffel ansehen
review.reviewRating Bewertung Erforderlich, wenn review angegeben ist. Damit wird die in der Rezension abgegebene Bewertung angegeben.
contentRating Text oder Altersfreigabe Erforderlich für Inhalte für Erwachsene, ansonsten dringend empfohlen: Gesamteinstufung der Inhalte. Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, sind zwei Varianten zulässig:
  • Die Ratingagentur wird dem Rating mit einem Leerzeichen vorangestellt. Beispiel: Die Altersfreigabe „TV-MA“ der Agentur „TVPG“ in den USA sollte als „TVPG TV-MA“ angegeben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Groß-/Kleinschreibung wird nicht berücksichtigt) gibt an, dass Sie die Altersfreigabe für die Inhalte nicht kennen.
contentRating.author Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Ratingagentur. Eine Liste der akzeptierten Einstufungsstellen finden Sie auf der Seite Einstufungsstellen.
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 (Gewalt in der Fantasie), L = Language (Sprache), S = Sexual Content (Sexuelle Inhalte), V = Violence (Gewalt).

Spezifikationen für Akteure

Mit der Eigenschaft actor in den Entitätstypen TVSeries, TVEpisode und TVSeason können Sie weitere Details zu den Schauspielern angeben, z. B. die Namen ihrer Figuren und die Rollen, die sie in der Serie spielen. Im folgenden Abschnitt wird dies zusammen mit einigen Beispielen zur Verdeutlichung der Verwendung erläutert.

Attribut Erwarteter Typ Beschreibung
actor Person oder PerformingGroup oder PerformanceRole Sehr empfehlenswert Warum? : Ein Array der Schauspieler.
  • Verwenden Sie den Typ PerformanceRole, wenn die Rolle und (optional) der Name der Figur des/der Darsteller(s) bekannt sind. Der Akteur Person oder PerformingGroup ist in diesem Fall in das PerformanceRole-Objekt eingebettet.
  • Verwenden Sie den Typ Person, um die einzelnen Schauspieler anzugeben, oder PerformingGroup, um Details zu den Künstlergruppen/Bands anzugeben, wenn die Rollen der Darsteller unbekannt sind.

Verwenden Sie ein Array, um mehrere Personen, Künstlergruppen oder Performance-Rollen darzustellen.

Person- oder PerformingGroup-Typen 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 Sehr empfehlenswert Warum? – Die Kennung des Akteurs oder der Gruppe im URI-Format, z. B. https://example.com/actor/abc. @id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog pro Akteur/Gruppe
  • 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 Unified Resource Identifier (URI)
  • Ihre Organisation muss Inhaber der für den @id-Wert verwendeten Domain sein.

Beachten Sie, dass die @id, die in der Property „actor“ verwendet wird, im gesamten Feed einheitlich verwendet werden sollte. Wenn beispielsweise zwei Filme denselben Schauspieler enthalten, sollte der Wert @id für diese beiden Schauspielerobjekte gleich bleiben.

name Text Erforderlich: Der Name des Schauspielers, der Schauspielerin, des Darstellers, der Darstellerin oder der Gruppe.
sameAs URL Sehr empfehlenswert Warum? – Eine URL zu einer Referenzwebseite, auf der der Schauspieler oder die Gruppe identifiziert werden kann, z. B. die Wikipedia-Seite des Schauspielers. Muss sich vom Attribut @id unterscheiden.

PerformanceRole-Typ 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 Sehr empfehlenswert Warum? – Eine Rolle, die von dem Schauspieler gespielt, aufgeführt oder ausgefüllt wird. Hier finden Sie eine Liste der akzeptablen Werte.
characterName Text Der Name einer Figur, die in einer Schauspiel- oder Performance-Rolle gespielt wird. Legen Sie dieses Feld nicht fest, wenn der Aktortyp PerformingGroup ist.
actor Person oder PerformingGroup Erforderlich :
  • Die Besetzung der Inhalte, wenn der Datentyp Person verwendet wird.
  • Die Gruppe(n)/Band(s) des Inhalts, wenn der Datentyp PerformingGroup verwendet wird.
actor.@type Person oder PerformingGroup Erforderlich: Muss immer auf Person oder PerformingGroup festgelegt sein.
actor.@id URL Sehr empfehlenswert Warum? – Die Kennung des Akteurs oder der Künstlergruppe im URI-Format, z. B. https://example.com/actor/abc. @id muss die folgenden Anforderungen erfüllen:
  • Global eindeutig in Ihrem Katalog pro Akteur/Gruppe
  • 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 Unified Resource Identifier (URI)
  • Ihre Organisation muss Inhaber der für den @id-Wert verwendeten Domain sein.

Beachten Sie, dass die @id, die in der Property „actor“ verwendet wird, im gesamten Feed einheitlich verwendet werden sollte. Wenn beispielsweise zwei Filme denselben Schauspieler enthalten, sollte der Wert @id für diese beiden Schauspielerobjekte gleich bleiben.

actor.name Text Erforderlich: Der Name des Schauspielers, der Schauspielerin, des Darstellers, der Darstellerin oder der Gruppe.
actor.sameAs URL Sehr empfehlenswert Warum? – Eine URL zu einer Referenzwebseite, auf der der Schauspieler oder die Gruppe identifiziert werden kann, z. B. die Wikipedia-Seite des Schauspielers. Sie 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 Synchronisation wird die Stimme des Schauspielers verwendet, der Schauspieler ist aber nicht auf dem Bildschirm zu sehen. Das ist am häufigsten bei Animationen der Fall, kann aber auch vorkommen, wenn die Stimme eines Schauspielers über die Sprache eines anderen Schauspielers synchronisiert wird.
„Doppelt“ Ein Double ist eine Person, die einen anderen Schauspieler ersetzt, sodass das Gesicht der Person nicht gezeigt wird.
„MotionCaptureActor“ Ein MotionCaptureActor ist eine Person, die Aktionen von menschlichen Schauspielern aufzeichnet und diese Informationen verwendet, um digitale Charaktermodelle in 2D- oder 3D-Computeranimationen zu animieren.

Diese Werte werden im Allgemeinen für die Typen Person und PerformingGroup akzeptiert.

roleName Wert Beschreibung
„Schauspieler“ 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.
„GuestStar“ „Ein Gaststar ist ein Schauspieler, der eine fiktive Rolle spielt und in einer oder wenigen Folgen auftritt. In einigen Fällen kann ein Gaststar eine wichtige wiederkehrende Figur spielen und viele Male in einer Serie auftreten, obwohl er nicht zur Hauptbesetzung gehört. Setze den Wert auf „GuestStar“, wenn die Besetzung eine Gastrolle hat oder Gast in der Show ist. Gaststars sollten nur auf der Folgenebene angegeben und nicht auf der Ebene der TV-Serie hinzugefügt werden.
„Gast“ „Ein Gast in einer Talkshow. „GuestStar“ ist eine fiktive Rolle, „Guest“ hingegen ein nicht fiktiver Auftritt.
„Ansager“ Ein Ansager ist eine Person, die die Eröffnungs- und Schlusstexte für die Show spricht, den Moderator, die Kandidaten und/oder die prominenten Gäste vorstellt, die verfügbaren Preise beschreibt und das Publikum vor der Aufzeichnung aufwärmt und während der Pausen unterhä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, dessen Darbietung aus der Nachahmung von Geräuschen, Stimmen und Eigenheiten von Prominenten und Zeichentrickfiguren besteht.
„Host“ Eine Person, die Fernsehsendungen einführt, präsentiert oder moderiert und oft als Vermittler zwischen der Sendung und dem Publikum fungiert. Die Rolle des Hosts ist in der Regel eine nicht fiktive Rolle.
„CoHost“ Eine Person, die eine Veranstaltung oder ein Programm gemeinsam mit einer oder mehreren anderen Personen moderiert.
„GuestHost“ Ein Gastmoderator ist ein Moderator, in der Regel einer Talkshow, der die Sendung anstelle des regulären Moderators moderiert, wenn dieser nicht verfügbar ist.
„Newscaster“ Eine Person, die die Öffentlichkeit in einer TV-Nachrichtensendung über lokale, nationale und internationale Nachrichten und Ereignisse informiert.
„Korrespondent“ Ein Korrespondent oder Reporter vor Ort ist in der Regel ein Journalist oder Kommentator für eine Zeitschrift oder ein Agent, der Berichte für eine Zeitung, Radio- oder Fernsehnachrichten oder ein anderes Unternehmen von einem abgelegenen, oft weit entfernten Ort aus verfasst.
„ShowJudge“ Ein Juror ist eine Person, die oft als Experte auf dem Gebiet der Show gilt und die Rolle des „Jurors“ erhält, um Kandidaten zu kritisieren, die für die TV-Serie vorsprechen und am Wettbewerb teilnehmen.
„Panelist“ Ein Mitglied einer Diskussions- oder Beratungsgruppe einer Radio- oder Fernsehsendung.
„Kandidat“ Ein Teilnehmer an einem Wettbewerb oder einer Gameshow 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 Musikinterpret kann eine Person, eine Gruppe oder eine fiktive Figur sein, die in der Regel regelmäßig vor einem Publikum aufgetreten ist oder Musiktitel oder Musikalben aufgenommen hat. Komponisten und Texter sollten diesen Typ nur haben, wenn aus den Credits eines Musikstücks hervorgeht, dass sie auch als Hauptinterpreten mitwirken. Mit diesem Typ können Sie Shows dauerhafte Musiker oder Musikergruppen sowie Gastmusiker oder Musikergruppen zuordnen.

Unterscheidung zwischen Haupt- und Nebenrolle eines Schauspielers

Um zwischen den Haupt- und Gast-/Nebendarstellern in einer TV-Show zu unterscheiden, fügen Sie die Hauptbesetzung nur in TVSeries-Entitäten und nur die Gastbesetzung oder Besetzung mit Nebenrollen in TVEpisode-Entitäten hinzu. Achte darauf, dass die Haupt- und reguläre Besetzung nicht den TVEpisode-Einheiten hinzugefügt wird.

Beispiele

TVSeries, TVEpisode und TVSeason – Beispiel

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 die Property „Actor

Rolle des Akteurs ist unbekannt

Wenn die Rolle eines Schauspielers unbekannt ist, empfehlen wir, die Schauspielerinformationen nur mit dem Person- oder PerformingGroup-Typ 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 Schauspielerinformationen mit dem PerformanceRole-Typ 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 von Schauspielern

Wenn keine Metadaten zur Rolle des Darstellers bekannt sind, empfehlen wir, die Schauspielerinformationen entweder mit dem Typ Person oder PerformingGroup anzugeben. Verwenden Sie für den anderen Fall, in dem diese Informationen bekannt sind, den Typ PerformanceRole . Diese Typen können im selben Array zusammen 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"
  }
]

Weitere Informationen zu den Themen, die mit diesen Attributen zusammenhängen, finden Sie auf den folgenden Seiten: