Markup-Eigenschaften von Filmen

Dieser Abschnitt enthält Details zu den Eigenschaften des Inhalts-Markups für den Entitätstyp Movie.

Spezifikationstabelle

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

TitelEIDR für den Film „Ghostbusters“ lautet beispielsweise „10.5240/7EC7-228A-510A-053E-CBB8-J“.
editEIDR Text Dringend empfohlen Warum? – Eine EIDR (Entertainment Identifier Registry), die eine bestimmte Änderung / Ausgabe für ein Werk eines Films oder einer TV-Sendung darstellt.

Wenn ein Film mit dem Namen „Ghostbusters“ mit dem Titel „EIDR“ „10.5240/7EC7-228A-510A-053E-CBB8-J“ mehrere Bearbeitungen hat, z. B. „10.5240/1F2A-E1C5-680A-14C6-E761-E761-E761-E761-E761-E761-E761-E761-E761-E761-E761-E761-E761-E761-F76

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

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

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

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

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

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

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

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

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

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

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

Wenn die Inhalte auf Dauer oder exklusiv verfügbar sind, setze endDate auf 20 Jahre ab dem aktuellen Datum.
releasedEvent.publishedBy Organisation oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
description Text Dringend empfohlen Warum? Eine Zusammenfassung des Films. übersichtliche Zusammenfassungen vorzuziehen. Max. 300 Zeichen.
duration Dauer Laufzeit des Films. Die Angabe erfolgt im ISO 8601-Format. Verwenden Sie das Format „PT00H00M“.
director Person Dringend empfohlen Warum? Der Regisseur des Films.
actor Person Dringend empfohlen Warum? Mitwirkende des Films
producer Organisation oder Person Dringend empfohlen Warum? Der/die Produzenten des Films
image ImageObject Erforderlich für Google TV: Bilder, die sich auf den Film beziehen Weitere Informationen zu den erforderlichen und optionalen Attributen für die Verwendung mit image findest du unter Bildeigenschaften.
trailer.description Text Die Beschreibung des Trailers. Siehe das Beispiel Trailer.
trailer.inLanguage Text Die Sprache des Trailers im BCP-47-Format.
trailer.url URL Eine URL eines Trailers, der öffentlich gehostet und von den jeweiligen Produktionsstudios oder autorisierten Quellen hochgeladen wurde.
trailer.regionsAllowed Ort Die Regionen, in denen die Medien zulässig sind. Wenn Sie nichts angeben, wird davon ausgegangen, dass sie überall zulässig ist. Geben Sie die Länder im ISO 3166-Format an.
identifier PropertyValue Dringend empfohlen Warum? – Externe oder andere ID, durch die diese Entität eindeutig identifiziert wird Mehrere IDs sind zulässig. Weitere Informationen finden Sie im Abschnitt Eigenschaften von Kennungen.
review Prüfung Bewertungen für den Film prüfen
review.reviewRating Bewertung Erforderlich, wenn eine Überprüfung angegeben wird. Hiermit wird die in der Rezension abgegebene Bewertung festgelegt.
contentRating Text oder Bewertung Erforderlich für Inhalte nur für Erwachsene, wird dringend empfohlen, andernfalls Warum? – Gesamtbewertung des Inhalts Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, sind zwei Varianten zulässig:
  • Die Bewertungsstelle, der die Bewertung vorangeht, mit einem Leerzeichen dazwischen. So sollte etwa die Altersfreigabe „PG-13“ der Agentur „MPAA“ in den USA als „MPAA PG-13“ beschrieben werden. Liste der Agenturen
  • Der Wert „RATING NOT KNOWN“ (Altersfreigabe nicht bekannt) (Groß-/Kleinschreibung nicht berücksichtigend) bedeutet, dass Sie die Altersfreigabe für den Film nicht kennen.
contentRating.author Text oder Organisation Erforderlich, wenn contentRating Rating verwendet: Der Name der Einstufungsstelle.
contentRating.ratingValue Text Erforderlich, wenn contentRating Rating verwendet: Der Wert der Bewertung.
contentRating.advisoryCode Text Der Beratungscode für den Inhalt. Zulässige Werte sind D, FV, L, S und V, D = Dialog, FV = Fantasiegewalt , L = Sprache, S = pornografische Inhalte, V = Gewalt.
popularityScore Beliebtheitsspezifikation Dringend empfohlen Warum? Ein Wert, den Google zusammen mit anderen Signalen verwendet, um Medien für Nutzer zu bestimmen. Diese Bewertung stellt die Beliebtheit der Inhalte in Bezug auf andere Inhalte in Ihrem Katalog dar. Daher muss die Skala der Bewertung in allen Feeds unter allen Entitäten in Ihrem Katalog einheitlich sein. Standardmäßig ist der Beliebtheitsfaktor der Entität auf 0 gesetzt.
popularityScore.@type Text Immer auf PopularityScoreSpecification festgelegt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Ein höherer Wert bedeutet eine höhere Beliebtheit.
popularityScore.eligibleRegion Land Region(en), in denen dieser Beliebtheitsfaktor gilt. Wenn der Beliebtheitswert weltweit anwendbar ist, legen Sie EARTH fest. Standardmäßig ist diese Property auf EARTH gesetzt.
Note: Die gebietsspezifische Beliebtheit hat Vorrang vor der globalen (EARTH) Beliebtheit
category Text Erforderlich, falls zutreffend: Füllen Sie diese Property, wenn die Entität eine Movie-Variante ist. Legen Sie category auf eine der folgenden Optionen fest:
  • Home Release: Eine Version, die für Home View verkauft oder ausgeliehen wird.
  • Theatrical Release: Eine Version, die im Kino veröffentlicht wurde.
  • International Release: Eine Version, die für die internationale Veröffentlichung bearbeitet wurde.
  • Remastered: Eine Version, deren Bilder, Ton oder beides auf einem aktuelleren Standard verbessert wurde.
  • Unrated: Eine Version, die von der MPAA oder einer ähnlichen Agentur nicht geprüft wird.
  • Director Cut: Eine Version, die die eigene genehmigte Änderung des Regisseurs darstellt.
  • Extended Cut: Eine Version, die länger ist als die Veröffentlichung im Kino.
workExample Film Gibt die Varianten des Films an. Fügen Sie diese Property in die Movie-Hauptentität ein, nicht in die Movie-Entitäten für die Variantenversionen.
workExample.@id URL Bei Movie-Varianten stellt diese Eigenschaft die @id der Movie-Entität bereit, von der es sich um eine Variante handelt.
workExample.@type Text Erforderlich: Immer auf Movie gesetzt. Dies kann als Array für ein Movie mit mehreren Varianten dargestellt werden.
workExample.@id URL Erforderlich: Der @id-Wert der Variante Movie.
workExample.name Text Erforderlich: Der Name der Variante Movie.
workExample.category Text Erforderlich: Der Typ der Filmvariante einer bestimmten Version. Legen Sie für die Kategorie einen der folgenden Werte fest:
  • Home Release: Eine Version, die für Home View verkauft oder ausgeliehen wird.
  • Theatrical Release: Eine Version, die im Kino veröffentlicht wurde.
  • International Release: Eine Version, die für die internationale Veröffentlichung bearbeitet wurde.
  • Remastered: Eine Version, deren Bilder, Ton oder beides auf einem aktuelleren Standard verbessert wurde.
  • Unrated: Eine Version, die von der MPAA oder einer ähnlichen Agentur nicht geprüft wird.
  • Director Cut: Eine Version, die die eigene genehmigte Änderung des Regisseurs darstellt.
  • Extended Cut: Eine Version, die länger ist als die Veröffentlichung im Kino.

Beispiel

Hauptfilm

Ein Film mit einer erweiterten Schnittvariante.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?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",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "contentRating": "RATING NOT KNOWN",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
  "workExample": {
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie_extended_cut",
      "name": "My Favorite Movie Extended Cut"
      "category": "Extended Cut"
  }
}

Erweiterte Schnittvariante

Die erweiterte Schnittversion des Hauptfilms.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie_extended_cut",
  "url": "http://www.example.com/my_favorite_movie_extended_cut",
  "name": "My Favorite Movie Extended Cut",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?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",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package",
        "identifier": "example.com:example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
  "contentRating": {
        "@type": "Rating",
        "author": "MPAA",
        "ratingValue": "R",
        "advisoryCode": "FV"
   },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is the extended cut of my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
 "exampleOfWork": {
  "@id": "http://www.example.com/my_favorite_movie",
 }
 "category": "Extended Cut"
}

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