Eigenschaften von Inhalts-Markup von TV-Sendungen

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

Die Angabe von TVSeason als vollständige Entität ist optional. Weitere Informationen findest du im Abschnitt Beziehungen zu TVSeries, TVSeason und TVEpisode.

Spezifikationstabelle

TVSeries

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich – immer auf ["http://schema.org", {"@language": "xx"}]
    festgelegt
  • Wo“ xx" ist die Sprache der Strings im Feed. Für jeden Kontext der Stammentität sollte @language auf den entsprechenden Sprachcode im Format BCP 47 festgelegt sein. Wenn als Sprache beispielsweise Spanisch eingestellt ist, wird angenommen, dass die Namen auf Spanisch sind, auch wenn die Sprache der Untertitel/Synchronisation auf Englisch ist.
@type Text Erforderlich: muss immer auf TVSeries gesetzt sein.
@id URL Erforderlich: Die ID des Inhalts im URI-Format. Beispiel: https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global in deinem Katalog einzigartig
  • Die ID sollte 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 von URI (Unified Resource Identifier)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen an eine 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 des Inhalts, die Google verwendet, um die Inhalte in Ihrem Feed mit den Inhalten in den Datenbanken von Google abzugleichen.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die Google crawlen kann.
Den Deeplink der Wiedergabe findest du unter der Eigenschaft urlTemplate des target-Objekts.
name Text Erforderlich: Der Name der Sendung. <ph type="x-smartling-placeholder">
    </ph>
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Sehen Sie sich das Beispiel Mehrere Regionen und Sprachen an.
  • Beachten Sie, dass nur ein Name pro Sprache unterstützt wird (Sprache-Land-Paar).
titleEIDR Text Dringend empfohlene Warum? – Eine EIDR-Kennung (Entertainment Identifier Registry), die allgemein bzw. abstrakt für ein Film- oder Fernsehwerk steht.

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

Außerdem kannst du mit FeaturedEvent angeben, dass dein Dienst diese Inhalte als Original, als angesagtes Video oder als Spezialität vermarktet.

ExclusiveEvent gibt an, dass dein Dienst die exklusiven Vertriebsrechte hat, und gib an, wo und wann.

Weitere Informationen und Beispiele findest du im Abschnitt „Beispiel“.
releasedEvent.@type Text Erforderlich – Legen Sie für diese Eigenschaft immer einen der folgenden Werte fest:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Die mit diesem Ereignis verknüpften Regionen.

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

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

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

Bei PublicationEvent gibt es das Datum der Erstveröffentlichung der Entität an, z. B. das Datum, an dem ein Film zum ersten Mal ins Kino kam.

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

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

Bei FeaturedEvent steht dies für das letzte Datum, an dem der Anbieter die Entität präsentiert.

Wenn die Inhalte dauerhaft exklusiv oder empfohlen werden, setze die endDate auf 20 Jahre ab dem aktuellen Datum.
releasedEvent.publishedBy Organization oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Dringend empfohlen Warum? Eine Zusammenfassung der Show. Zusammenfassungen von Diagrammen werden gegenüber sachlichen Zusammenfassungen bevorzugt. Maximal 300 Zeichen.
actor Person oder PerformingGroup oder PerformanceRole Dringend empfohlen Warum? Ein Array mit den Darstellern der Serie. Weitere Informationen zur Modellierung
director Person Dringend empfohlen Warum? Der Regisseur der Show.
producer Organization oder Person Dringend empfohlen Warum? Die Produzenten der Show.
image ImageObject Erforderlich für Google TV: die Bilder, die mit TVSeries zu tun haben Weitere Informationen zu den erforderlichen und optionalen Eigenschaften für image finden Sie unter Bildeigenschaften.
trailer.description Text Die Beschreibung des Trailers. Hier ein Beispiel für einen 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 wird.
trailer.regionsAllowed Ort Die Regionen, in denen Medien zulässig sind. Wenn keine Angabe erfolgt, wird davon ausgegangen, dass sie überall zulässig ist. Geben Sie die Länder im ISO 3166-Format an.
identifier PropertyValue Dringend empfohlene Warum? – Externe oder andere ID, die diese Entität eindeutig identifiziert Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt Eigenschaften der Kennzeichnung.
popularityScore PopularityScoreSpecification Dringend empfohlen Warum? Eine Bewertung, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer abgespielt werden. Dieser Wert gibt an, wie beliebt der Inhalt im Vergleich zu anderen Inhalten in deinem Katalog ist. Daher muss die Skala des Werts in Ihren Feeds und bei allen Entitäten in Ihrem Katalog einheitlich sein. Die Beliebtheitsrate einer Entität ist standardmäßig auf 0 festgelegt.
popularityScore.@type Text Immer auf PopularityScoreSpecification festlegen.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Je höher die Bewertung, desto beliebter sind sie.
popularityScore.eligibleRegion Land Region(en), in der dieser Beliebtheitswert gilt. Wenn die Beliebtheitsrate weltweit anwendbar ist, legen Sie diesen Wert auf EARTH fest. Diese Eigenschaft ist standardmäßig auf EARTH festgelegt.
Note: Die sprachspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH).
review Rezension Altersfreigaben der Serie prüfen
review.reviewRating Bewertung Erforderlich, wenn review angegeben ist Damit wird die in der Rezension abgegebene Bewertung angegeben.
contentRating Text oder Rating Erforderlich für Inhalte nur für Erwachsene, andernfalls dringend empfohlen: Gesamtbewertung des Inhalts. Wird die Inhaltsbewertung in Form einer Zeichenfolge angegeben, sind zwei Varianten zulässig:
  • Die Rating-Agentur, die der Bewertung durch ein Leerzeichen vorangestellt wurde. Beispiel: „TV-MA“ Bewertung der Agentur "TVPG" in den USA als „TVPG TV-MA“ beschrieben werden. Liste der Agenturen
  • Der Wert "BEWERTUNG NICHT WISSEN" (Groß-/Kleinschreibung nicht berücksichtigend), um darauf hinzuweisen, dass die Altersfreigabe für den Inhalt nicht bekannt ist.
contentRating.author Text oder Organization Erforderlich, wenn contentRating Rating verwendet: Name der Rating-Agentur. Auf der Seite Agenturen für die Altersfreigabe finden Sie eine Liste der akzeptierten Rating-Agenturen.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Empfehlungscode für den Inhalt. Zulässige Werte sind D, FV, L, S und V. D = Dialog, FV = Fantasiegewalt, L = Sprache, S = Sexuelle Inhalte, V = Gewalt.

TVEpisode

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich – immer auf ["http://schema.org", {"@language": "xx"}]
    festgelegt
  • Wo“ xx" ist die Sprache der Strings im Feed. Für jeden Kontext der Stammentität sollte @language auf den entsprechenden Sprachcode im Format BCP 47 festgelegt sein. Wenn als Sprache beispielsweise Spanisch eingestellt ist, wird angenommen, dass die Namen auf Spanisch sind, auch wenn die Sprache der Untertitel/Synchronisation auf Englisch ist.
@type Text Erforderlich: muss immer auf TVEpisode gesetzt sein.
@id URL Erforderlich: Die ID des Inhalts im URI-Format. Beispiel: https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global in deinem Katalog einzigartig
  • Die ID sollte 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 von URI (Unified Resource Identifier)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen an eine 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 des Inhalts, die Google verwendet, um die Inhalte in Ihrem Feed mit den Inhalten in den Datenbanken von Google abzugleichen.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die Google crawlen kann.
Den Deeplink der Wiedergabe findest du unter der Eigenschaft urlTemplate des target-Objekts.
name Text Erforderlich: Der Name der Folge. <ph type="x-smartling-placeholder">
titleEIDR Text Dringend empfohlen Warum? – Eine EIDR-Kennung (Entertainment Identifier Registry), die allgemein bzw. abstrakt für ein Film- oder Fernsehwerk steht.

Beispiel: titleEIDR für die erste Folge der ersten Staffel von TVSeries, bekannt als „Game of Thrones“ ist „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X“.
editEIDR Text Dringend empfohlen Warum? – Eine EIDR-Kennung (Entertainment Identifier Registry), die eine bestimmte Fassung / Ausgabe eines Film- oder Fernsehwerks darstellt.

Die erste Folge der ersten Staffel von TVSeries mit dem Namen „Game of Thrones“ mit dem TitelEIDR „10.5240/B6A6-1B32-B5E5-D5CB-6B84-X“ enthält eine Änderung, z.B. &quot;10.5240/FB97-C847-2969-D0AB-ECD1-C&quot;.

titleEIDR-Property ist erforderlich, wenn editEIDR bereitgestellt wird.
inLanguage Text Originalsprache der Reihe im BCP 47-Format.
episodeNumber Ganzzahl Erforderlich: Die Zahl, die die Position dieser Folge in der Reihenfolge der Folgen einer Staffel angibt. episodeNumber muss für jede Saison neu gestartet werden. Das heißt, die erste Folge jeder Staffel muss 1 sein.
partOfSeason TVSeason Erforderlich: die TV-Staffel, zu der diese Folge gehört.

Auch wenn TVEpisode keine entsprechende TVSeason hat, musst du die Properties partOfSeason.@id und partOfSeason.seasonNumber angeben. Eine Behelfslösung:
  • Nehmen Sie partofSeries.@id (z. B. http://www.example.com/my_favorite_tv_show) und fügen Sie ein Platzhalter-Suchanfragenfeld an (z. B. http://www.example.com/my_favorite_tv_show), um eine eindeutige partOfSeason.@id zu erstellen (z. B. http://www.example.com/my_favorite_tv_show).
  • Setzen Sie partOfSeason.seasonNumber auf 1.
partOfSeason.@type Text Erforderlich: muss immer auf TVSeason gesetzt sein.
partOfSeason.@id URL Erforderlich: @id von TVSeason, zu der diese Folge gehört.
partOfSeason.seasonNumber Ganzzahl Erforderlich: Die Zahl, die die Position der Staffel in der Reihenfolge der Staffeln angibt.
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: @id von TVSeries, zu der diese Folge gehört.
partOfSeries.name Text Erforderlich: Der Name der Serie.
partOfSeries.sameAs Text Eine URL zu einer Referenzwebseite, auf der die Sendung identifiziert werden kann z. B. die Wikipedia-Seite der Sendung. Dies muss sich von der url-Property unterscheiden.
potentialAction WatchAction Erforderlich, falls zutreffend: ein Aktions-Markup-Objekt, das die Details der Aktion enthält
  • Wenn die Inhalte auf Video-on-Demand (VoD) verfügbar sind, ist diese Eigenschaft erforderlich. Das Aktions-Markup-Objekt muss den Deeplink des Inhalts bereitstellen.
  • Wenn die Inhalte auf einem LiveTV-Kanal verfügbar sind, ist diese Eigenschaft optional. Die verknüpfte BroadcastService-Entität stellt stattdessen den Deeplink des Kanals bereit.
  • Ein TVEpisode kann sowohl über VoD als auch Live-TV verfügbar sein.
Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Sehen Sie sich das Beispiel Mehrere Regionen und Sprachen an.
sameAs Dringend empfohlen Warum? URL Eine URL zu einer Referenzwebseite, auf der die Folge identifiziert werden kann z. B. die Wikipedia-Seite der Folge. Dies muss sich von der url-Property unterscheiden.
duration Dauer Laufzeit der Folge im ISO 8601-Format. Verwenden Sie dieses Format: „PT00H00M“.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Dringend empfohlen Warum? – Ein PublicationEvent wird verwendet, um die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch einen Verlag oder Webpublisher anzugeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Außerdem kannst du mit FeaturedEvent angeben, dass dein Dienst diese Inhalte als Original, als angesagtes Video, als Spezialität vermarktet usw.

ExclusiveEvent gibt an, dass dein Dienst die exklusiven Vertriebsrechte hat und wo und wann du gibst, wo und wann.

Weitere Informationen und Beispiele findest du in diesem Abschnitt.
releasedEvent.@type Text Erforderlich – Legen Sie für diese Eigenschaft immer einen der folgenden Werte fest:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Die mit diesem Ereignis verknüpften Regionen.

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

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

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

Bei PublicationEvent gibt es das Datum der Erstveröffentlichung der Entität an, z. B. das Datum, an dem ein Film zum ersten Mal ins Kino kam.

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

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

Bei FeaturedEvent steht dies für das letzte Datum, an dem der Anbieter die Entität präsentiert.

Wenn die Inhalte dauerhaft exklusiv oder empfohlen werden, setze die endDate auf 20 Jahre ab dem aktuellen Datum.
releasedEvent.publishedBy Organization oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Dringend empfohlen Warum? Eine Zusammenfassung der Folge. Zusammenfassungen von Diagrammen werden gegenüber sachlichen Zusammenfassungen bevorzugt. Maximal 300 Zeichen.
genre Text Eine geordnete Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Suchbegriffe oder Tags, mit denen dieser Inhalt beschrieben wird. Ein Array von Keywords ist ebenfalls zulässig. Zum Beispiel kann ["feature, biography"] ein Array mit Suchbegriffen sein, die den Inhalt beschreiben.
actor Person oder PerformingGroup oder PerformanceRole Dringend empfohlene Warum? Auflistung der Darsteller der Folge Weitere Informationen zur Modellierung
director Person Dringend empfohlen Warum? Der Regisseur der Folge.
producer Organization oder Person Dringend empfohlen Warum? Die Produzenten der Staffel.
image ImageObject Dringend empfohlene Warum? für Google TV – verschiedene Bilder im Zusammenhang mit der TVEpisode. Weitere Informationen zu den erforderlichen und optionalen Eigenschaften für image finden Sie unter Bildeigenschaften.
trailer.description Text Die Beschreibung des Trailers. Hier ein Beispiel für einen 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 wird.
trailer.regionsAllowed Ort Die Regionen, in denen Medien zulässig sind. Wenn keine Angabe erfolgt, wird davon ausgegangen, dass sie überall zulässig ist. Geben Sie die Länder im ISO 3166-Format an.
review Rezension Altersfreigaben der TV-Folge prüfen
review.reviewRating Bewertung Erforderlich, wenn review angegeben ist Damit wird die in der Rezension abgegebene Bewertung angegeben.
contentRating Text oder Rating Erforderlich für Inhalte nur für Erwachsene, andernfalls dringend empfohlen: Gesamtbewertung des Inhalts. Wird die Inhaltsbewertung in Form einer Zeichenfolge angegeben, sind zwei Varianten zulässig:
  • Die Rating-Agentur, die der Bewertung durch ein Leerzeichen vorangestellt wurde. Beispiel: „TV-MA“ Bewertung der Agentur "TVPG" in den USA als „TVPG TV-MA“ beschrieben werden. Liste der Agenturen
  • Der Wert "BEWERTUNG NICHT WISSEN" (Groß-/Kleinschreibung nicht berücksichtigend), um darauf hinzuweisen, dass die Altersfreigabe für den Inhalt nicht bekannt ist.
contentRating.author Text oder Organization Erforderlich, wenn contentRating Rating verwendet: Name der Rating-Agentur. Auf der Seite Agenturen für die Altersfreigabe finden Sie eine Liste der akzeptierten Rating-Agenturen.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Empfehlungscode für den Inhalt. Zulässige Werte sind D, FV, L, S und V. D = Dialog, FV = Fantasiegewalt, L = Sprache, S = Sexuelle Inhalte, V = Gewalt.
identifier PropertyValue Dringend empfohlene Warum? – Externe oder andere ID, die diese Entität eindeutig identifiziert Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt Eigenschaften der Kennzeichnung.
popularityScore PopularityScoreSpecification Dringend empfohlen Warum? Eine Bewertung, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer abgespielt werden. Dieser Wert gibt an, wie beliebt der Inhalt im Vergleich zu anderen Inhalten in deinem Katalog ist. Daher muss die Skala des Werts in Ihren Feeds und bei allen Entitäten in Ihrem Katalog einheitlich sein. Die Beliebtheitsrate einer Entität ist standardmäßig auf 0 festgelegt.
popularityScore.@type Text Immer auf PopularityScoreSpecification festlegen.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Je höher die Bewertung, desto beliebter sind sie.
popularityScore.eligibleRegion Land Region(en), in der dieser Beliebtheitswert gilt. Wenn die Beliebtheitsrate weltweit anwendbar ist, legen Sie diesen Wert auf EARTH fest. Diese Eigenschaft ist standardmäßig auf EARTH festgelegt.
Note: Die sprachspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH).

TVSeason

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich – immer auf ["http://schema.org", {"@language": "xx"}]
    festgelegt
  • Wo“ xx" ist die Sprache der Strings im Feed. Für jeden Kontext der Stammentität sollte @language auf den entsprechenden Sprachcode im Format BCP 47 festgelegt sein. Wenn als Sprache beispielsweise Spanisch eingestellt ist, wird angenommen, dass die Namen auf Spanisch sind, auch wenn die Sprache der Untertitel/Synchronisation auf Englisch ist.
@type Text Erforderlich: muss immer auf TVSeason gesetzt sein.
@id URL Erforderlich: Die ID des Inhalts im URI-Format. Beispiel: https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Global in deinem Katalog einzigartig
  • Die ID sollte 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 von URI (Unified Resource Identifier)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen an eine 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 des Inhalts, die Google verwendet, um die Inhalte in Ihrem Feed mit den Inhalten in den Datenbanken von Google abzugleichen.
url muss die folgenden Anforderungen erfüllen:
  • url muss global eindeutig sein
  • url muss eine funktionierende kanonische URL enthalten, die Google crawlen kann.
Den Deeplink der Wiedergabe findest du unter der Eigenschaft urlTemplate des target-Objekts.
name Text Erforderlich: Der Name dieser TV-Staffel. <ph type="x-smartling-placeholder">
titleEIDR Text Dringend empfohlen Warum? – Eine EIDR-Kennung (Entertainment Identifier Registry), die allgemein bzw. abstrakt für ein Film- oder Fernsehwerk steht.

Beispiel: titleEIDR für die erste Staffel von TVSeries, bekannt als „Game of Thrones“ ist „10.5240/FD91-C72C-4161-FCBA-058B-1“.
seasonNumber Ganzzahl Erforderlich: Die Zahl, die die Position der Staffel in der Reihenfolge der Staffeln angibt.
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: @id der TVSeries, zu der diese Staffel gehört.
partOfSeries.name Text Erforderlich: Der Name der Serie.
partOfSeries.sameAs Text Eine URL zu einer Referenzwebseite, auf der die Sendung identifiziert werden kann z. B. die Wikipedia-Seite der Sendung. Dies muss sich von der url-Property unterscheiden.
potentialAction WatchAction Erforderlich, falls zutreffend: ein Aktions-Markup-Objekt, das die Details der Aktion enthält
  • Wenn die Inhalte auf Video-on-Demand (VoD) verfügbar sind, ist diese Eigenschaft erforderlich. Das Aktions-Markup-Objekt muss den Deeplink des Inhalts bereitstellen.
  • Wenn die Inhalte auf einem LiveTV-Kanal verfügbar sind, ist diese Eigenschaft optional. Die verknüpfte BroadcastService-Entität stellt stattdessen den Deeplink des Kanals bereit.
  • Ein TVSeason kann sowohl über VoD als auch Live-TV verfügbar sein.
Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Sehen Sie sich das Beispiel Mehrere Regionen und Sprachen an.
sameAs URL Dringend empfohlene Warum? Eine URL zu einer Referenzwebseite, auf der die Staffel identifiziert werden kann zum Beispiel die Wikipedia-Seite der Saison. Dies muss sich von der url-Property unterscheiden.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Dringend empfohlen Warum? – Ein PublicationEvent wird verwendet, um die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch einen Verlag oder Webpublisher anzugeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Außerdem kannst du mit FeaturedEvent angeben, dass dein Dienst diese Inhalte als Original, als angesagtes Video, als Spezialität vermarktet usw.

ExclusiveEvent gibt an, dass dein Dienst die exklusiven Vertriebsrechte hat und wo und wann angegeben wird.

Weitere Informationen und Beispiele findest du im Abschnitt „Beispiel“.
releasedEvent.@type Text Erforderlich – Legen Sie für diese Eigenschaft immer einen der folgenden Werte fest:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Die mit diesem Ereignis verknüpften Regionen.

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

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

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

Bei PublicationEvent gibt es das Datum der Erstveröffentlichung der Entität an, z. B. das Datum, an dem ein Film zum ersten Mal ins Kino kam.

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

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

Bei FeaturedEvent steht dies für das letzte Datum, an dem der Anbieter die Entität präsentiert.

Wenn die Inhalte dauerhaft exklusiv oder empfohlen werden, setze die endDate auf 20 Jahre ab dem aktuellen Datum.
releasedEvent.publishedBy Organization oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Dringend empfohlen Warum? Eine Zusammenfassung der Staffel. Zusammenfassungen von Diagrammen werden gegenüber sachlichen Zusammenfassungen bevorzugt. Maximal 300 Zeichen.
actor [Person oder PerformingGroup oder PerformanceRole Dringend empfohlen Warum? Hier siehst du die Besetzung der Staffel. Weitere Informationen zur Modellierung
director Person Dringend empfohlen Warum? Auflistung der Regisseure der Serie
producer Organization oder Person Dringend empfohlen Warum? Die Produzenten der Staffel.
image ImageObject Die zur TV-Staffel gehörigen Bilder. Weitere Informationen zu den erforderlichen und optionalen Eigenschaften für image finden Sie unter Bildeigenschaften.
genre Text Eine geordnete Liste aller relevanten Genres. Beispiel : ["Action", "Fashion", "Environment", "Football"]
keywords Text Suchbegriffe oder Tags, mit denen dieser Inhalt beschrieben wird. Ein Array von Keywords ist ebenfalls zulässig. Zum Beispiel kann ["feature, biography"] ein Array mit Suchbegriffen sein, die den Inhalt beschreiben.
trailer.description Text Die Beschreibung des Trailers. Hier ein Beispiel für einen 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 wird.
trailer.regionsAllowed Ort Die Regionen, in denen Medien zulässig sind. Wenn keine Angabe erfolgt, wird davon ausgegangen, dass sie überall zulässig ist. Geben Sie die Länder im ISO 3166-Format an.
identifier PropertyValue Dringend empfohlene Warum? – Externe oder andere ID, die diese Entität eindeutig identifiziert Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt Eigenschaften der Kennzeichnung.
popularityScore PopularityScoreSpecification Dringend empfohlen Warum? Eine Bewertung, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer abgespielt werden. Dieser Wert gibt an, wie beliebt der Inhalt im Vergleich zu anderen Inhalten in deinem Katalog ist. Daher muss die Skala des Werts in Ihren Feeds und bei allen Entitäten in Ihrem Katalog einheitlich sein. Die Beliebtheitsrate einer Entität ist standardmäßig auf 0 festgelegt.
popularityScore.@type Text Immer auf PopularityScoreSpecification festlegen.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Je höher die Bewertung, desto beliebter sind sie.
popularityScore.eligibleRegion Land Region(en), in der dieser Beliebtheitswert gilt. Wenn die Beliebtheitsrate weltweit anwendbar ist, legen Sie diesen Wert auf EARTH fest. Diese Eigenschaft ist standardmäßig auf EARTH festgelegt.
Note: Die sprachspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH).
review Rezension Bewertungen für die Serienstaffel ansehen
review.reviewRating Bewertung Erforderlich, wenn review angegeben ist Damit wird die in der Rezension abgegebene Bewertung angegeben.
contentRating Text oder Rating Erforderlich für Inhalte nur für Erwachsene, andernfalls dringend empfohlen: Gesamtbewertung des Inhalts. Wird die Inhaltsbewertung in Form einer Zeichenfolge angegeben, sind zwei Varianten zulässig:
  • Die Rating-Agentur, die der Bewertung durch ein Leerzeichen vorangestellt wurde. Beispiel: „TV-MA“ Bewertung der Agentur "TVPG" in den USA als „TVPG TV-MA“ beschrieben werden. Liste der Agenturen
  • Der Wert "BEWERTUNG NICHT WISSEN" (Groß-/Kleinschreibung nicht berücksichtigend), um darauf hinzuweisen, dass die Altersfreigabe für den Inhalt nicht bekannt ist.
contentRating.author Text oder Organization Erforderlich, wenn contentRating Rating verwendet: Name der Rating-Agentur. Auf der Seite Agenturen für die Altersfreigabe finden Sie eine Liste der akzeptierten Rating-Agenturen.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Empfehlungscode für den Inhalt. Zulässige Werte sind D, FV, L, S und V. D = Dialog, FV = Fantasiegewalt, L = Sprache, S = Sexuelle Inhalte, V = Gewalt.

Angaben zum Akteur

Mit der Eigenschaft actor in den Entitätstypen TVSeries, TVEpisode und TVSeason kannst du weitere Details zu den Schauspielern angeben, einschließlich der Namen der Figuren und der Rollen, die sie in der Serie spielen. In den folgenden Abschnitten wird dies mit einigen Beispielen zur Erläuterung der Verwendung beschrieben.

Attribut Erwarteter Typ Beschreibung
actor Person oder PerformingGroup oder PerformanceRole Dringend empfohlene Warum? : ein Array der Darsteller.

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

Mit dem Typ Person oder PerformingGroup

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

Attribut Erwarteter Typ Beschreibung
@type Person oder PerformingGroup Required (Erforderlich): immer auf Person oder PerformingGroup festlegen
@id URL Dringend empfohlen Warum? – Akteure oder Gruppenkennungen im URI-Format Beispiel: https://beispiel.de/actor/abc. @id muss die folgenden Anforderungen erfüllen:
  • Global einzigartig in Ihrem Katalog pro Akteur/Leistungsgruppe
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern. Er wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form von URI (Unified Resource Identifier)
  • Ihre Organisation muss Inhaber der Domain sein, die für den Wert @id verwendet wird.

Das Attribut @id, das in der Property „actor“ verwendet wird, sollte im gesamten Feed einheitlich verwendet werden. Wenn es beispielsweise zwei Filme mit demselben Schauspieler gibt, sollte der Wert @id für diese beiden Schauspielerobjekte beibehalten werden.

name Text Erforderlich: Der Name des Schauspielers, der Schauspielerin, der Besetzungsgruppe oder der Darstellenden Gruppe.
sameAs URL Dringend empfohlen Warum? – Eine URL zu einer Referenzwebseite, auf der der Schauspieler oder die darstellende Gruppe identifiziert werden kann; zum Beispiel die Wikipedia-Seite des Schauspielers. Dies muss sich von der @id-Property unterscheiden.

Typ PerformanceRole verwenden

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

Attribut Erwarteter Typ Beschreibung
@type PerformanceRole Erforderlich: ist immer auf PerformanceRole festgelegt.
roleName Text Dringend empfohlen Warum? – Eine Rolle, die der Darsteller gespielt, aufgeführt oder erfüllt hat Eine Liste der zulässigen Werte finden Sie hier.
characterName Text Der Name einer Figur, die in einer Schauspiel- oder Darbietung gespielt wird. Verwenden Sie dieses Feld nicht, wenn der Akteurtyp PerformingGroup ist.
actor Person oder PerformingGroup Erforderlich –
  • Die Mitwirkenden des Inhalts, wenn der Datentyp Person verwendet wird.
  • Die Performance-Gruppe(n)/-Band(s) der Inhalte, wenn der Datentyp PerformingGroup verwendet wird.
actor.@type Person oder PerformingGroup Required (Erforderlich): immer auf Person oder PerformingGroup festlegen
actor.@id URL Dringend empfohlen Warum? – Akteur oder Gruppenkennung im URI-Format Beispiel: https://beispiel.de/actor/abc. @id muss die folgenden Anforderungen erfüllen:
  • Global einzigartig in Ihrem Katalog pro Akteur/Leistungsgruppe
  • Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern. Er wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form von URI (Unified Resource Identifier)
  • Ihre Organisation muss Inhaber der Domain sein, die für den Wert @id verwendet wird.

Das Attribut @id, das in der Property „actor“ verwendet wird, sollte im gesamten Feed einheitlich verwendet werden. Wenn es beispielsweise zwei Filme mit demselben Schauspieler gibt, sollte der Wert @id für diese beiden Schauspielerobjekte beibehalten werden.

actor.name Text Erforderlich: Der Name des Schauspielers, der Schauspielerin, der Besetzungsgruppe oder der Darstellenden Gruppe.
actor.sameAs URL Dringend empfohlen Warum? – Eine URL zu einer Referenzwebseite, auf der der Schauspieler oder die darstellende Gruppe identifiziert werden kann; zum Beispiel die Wikipedia-Seite des Schauspielers. Sie muss sich von der Eigenschaft 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 einem Synchronsprecher kommt die Stimme des Schauspielers zum Einsatz, aber der Schauspieler erscheint nicht auf dem Bildschirm. Dies ist am häufigsten in Animationen zu finden, tritt aber auch auf, wenn die Stimme eines Schauspielers statt der Sprache eines anderen Schauspielers synchronisiert 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 Aktionen menschlicher Schauspieler aufzeichnet und diese Informationen verwendet, um digitale Charaktermodelle in 2D- oder 3D-Computeranimation 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 Darbietung 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 mehreren Folgen auftritt. Es kann vorkommen, dass ein Gaststar eine wichtige wiederkehrende Figur spielt und mehrmals in einer Serie auftritt, auch wenn er nicht zum Hauptdarsteller gehört. Wert auf „GuestStar“ festlegen Die Besetzung hat einen Gastauftritt oder ist Gast der Show. Gaststars sollten nur auf Folgenebene und nicht auf TVSeries-Ebene angegeben werden.
„Gast“ „Ein Gast in einer Talkshow. Während "GuestStar" ist eine fiktive Rolle, eine fiktive Erscheinung.
„Sprecherin“ Eine Sprecherin ist eine Person, die Eröffnungs- und Schlussspiele für die Show abliefert, den Moderator, die Teilnehmer und/oder Prominenten vorstellt, die verfügbaren Preise beschreibt und das Publikum vor der Aufnahme aufwärmt und es in den Pausen unterhält.
„Kommentator“ Ein Kommentator kommentiert ein Spiel oder ein Ereignis in Echtzeit, meist während einer Liveübertragung.
"Impressionismus" Ein Impressionist oder Nachahmung ist ein Darsteller, dessen Handlung aus der Nachahmung von Klängen, Stimmen und Manierismus von Prominenten und Zeichentrickfiguren besteht.
„Moderator“ Eine Person, die Fernsehsendungen präsentiert, präsentiert oder moderiert und häufig als Vermittler für die Sendung und das Publikum fungiert. Der „Moderator“ ist meist eine Sachbücher.
„CoHost“ Eine Person, die gemeinsam mit einer anderen Person eine Veranstaltung oder ein Programm veranstaltet.
„GuestHost“ Ein Gastmoderator ist ein Moderator, in der Regel eine Talkshow, die anstelle des regulären Moderators das Programm veranstaltet, wenn keine Verfügbarkeit vorhanden ist.
„Nachrichtensprecher“ Person, die die Öffentlichkeit im Rahmen eines TV-Nachrichtenprogramms über Nachrichten und Ereignisse auf lokaler, nationaler und internationaler Ebene informiert bzw. informiert.
"Korrespondent" Korrektoren oder Journalisten sind in der Regel ein Journalist oder Kommentator einer Zeitschrift oder ein Agent, der von einem entlegenen, oft entfernten Standort aus für eine Zeitung, Radio- oder Fernsehnachrichten oder eine andere Art von Unternehmen schreibt.
„Richter anzeigen“ Ein Richter ist eine Person, die oft als Experte auf dem Gebiet der Show gilt und die Rolle des „Richters“ übernimmt. um Teilnehmer zu kritisieren, die für die Serie vorspielen und am Wettbewerb der Fernsehserie teilnehmen.
„Panelmitglied“ Mitglied einer Diskussion oder eines Beratungsgremiums eines Radio- oder Fernsehpanels.
"Teilnehmer" Ein Teilnehmer in einem Wettbewerb oder einer Spielshow ist jemand, der daran teilnimmt.
„StoryNarrator“ (Geschichtensprecher) Ein Erzähler ist eine Person, die etwas erzählt, insbesondere eine Figur, die die Ereignisse eines Romans oder eines Gedichts nacherzählt.
„MusicalArtist“ Ein Musiker kann eine Person, eine Gruppe oder eine fiktive Figur sein, die normalerweise regelmäßig vor einem Publikum aufgetreten ist oder Musikalben oder Musikalben aufgenommen hat. Komponisten und Texter sollten diesen Typ nur haben, wenn die Mitwirkende an einigen musikalischen Werken darauf schließen lassen, dass sie auch als Hauptdarsteller mitwirken. Dieser Typ kann verwendet werden, um dauerhafte Musiker oder Musikergruppen und Gastmusiker oder Musikergruppen mit Shows zu verknüpfen.

Zwischen der Haupt- und der Nebenrolle eines Schauspielers unterscheiden

Wenn du zwischen Hauptdarstellern/regulären Schauspielern und Gast-/unterstützenden Schauspielern in einer Serie unterscheiden möchtest, füge nur die Hauptdarsteller in den TVSeries-Entitäten hinzu und füge nur die Gast- bzw. Nebenrollen zu den TVEpisode-Entitäten hinzu. Achten Sie darauf, dass die Haupt- oder reguläre Umwandlung nicht den TVEpisode-Entitäten hinzugefügt wurde.

Beispiele

Beispiel für TVSeries, TVEpisode und TVSeason

TVSeries 

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

TVEpisode 

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

TVSeason 

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

Beispiele für Actor-Properties

Die Rolle des Schauspielers ist unbekannt

Wenn die Rolle eines Schauspielers unbekannt ist, empfehlen wir, ihm nur Informationen über den Typ Person oder PerformingGroup zu geben.

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

Die Rolle des Schauspielers ist bekannt

Wenn die Rolle eines Schauspielers bekannt ist, empfehlen wir, ihm Informationen über den Typ PerformanceRole zur Verfügung zu stellen.

"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 Untergruppe von Schauspielern

Wenn die Metadaten zur Aufführungsrolle nicht bekannt sind, empfehlen wir, Informationen zum Schauspieler entweder mit dem Typ Person oder PerformingGroup zur Verfügung zu stellen. Wenn diese Informationen bekannt sind, verwenden Sie den Typ PerformanceRole . Diese Typen können zusammen im selben Array hinzugefügt werden.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

Auf den folgenden Seiten finden Sie Informationen zu Themen im Zusammenhang mit diesen Properties: