Inhalts-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
  • Wo“ xx" ist die Sprache der Strings im Feed. Für jeden Stammentitätskontext sollte @language auf den entsprechenden Sprachcode im BCP-47-Format eingestellt 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: Für Filme immer auf Movie gesetzt.
@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
  • Statisch; Die ID sollte immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Er 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 des Films.
  • 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 den Film „Ghostbusters“. ist „10.5240/7EC7-228A-510A-053E-CBB8-J“.
editEIDR Text Dringend empfohlene Warum? – Eine EIDR-Kennung (Entertainment Identifier Registry), die eine bestimmte Fassung / Ausgabe eines Film- oder Fernsehwerks darstellt.

Zum Beispiel der als „Ghostbusters“ bekannte Film mit dem TitelEIDR „10.5240/7EC7-228A-510A-053E-CBB8-J“, enthält mehrere Bearbeitungen, z.B. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" und „10.5240/8A35-3BEE-6497-5D12-9E4F-3“.

titleEIDR-Property ist erforderlich, wenn editEIDR bereitgestellt wird.
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 Movie 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, die den Film identifizieren kann; zum Beispiel die Wikipedia-Seite des Films. Dies muss sich von der url-Property unterscheiden.
inLanguage Text Originalsprache des Films im BCP 47-Format.
genre Text Eine geordnete Liste aller relevanten Genres. Beispiel : ["Aktion", "Mode", "Umwelt", "Fußball"]
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, 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 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 EmpfohlenErforderlich 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 EmpfohlenErforderlich 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 empfohlene Warum? Eine Zusammenfassung des Films. Zusammenfassungen von Diagrammen werden gegenüber sachlichen Zusammenfassungen bevorzugt. Maximal 300 Zeichen.
duration Dauer Laufzeit des Films. Die Angabe erfolgt im ISO 8601-Format. Verwenden Sie dieses Format: „PT00H00M“.
director Person Dringend empfohlene Warum? Die Regisseure des Films.
actor Person Dringend empfohlene Warum? Die Besetzung des Films.
producer Organization oder Person Dringend empfohlene Warum? Die Produzenten des Films.
image ImageObject Erforderlich für Google TV: die zum Film gehörigen Bilder 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.
review Rezension Bewertungen für den Film ansehen
review.reviewRating Bewertung Erforderlich, wenn eine Überprüfung vorliegt. Hiermit wird die in der Rezension abgegebene Bewertung angegeben.
contentRating Text oder Rating Erforderlich für Inhalte nur für Erwachsene, ansonsten empfohlen Warum? – 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: „PG-13“ Bewertung der Agentur "MPAA" in den USA als "MPAA PG-13" beschrieben werden. Liste der Agenturen
  • Der Wert "BEWERTUNG NICHT WISSEN" (Groß-/Kleinschreibung nicht berücksichtigend), um anzuzeigen, dass die Altersfreigabe für den Film nicht bekannt ist.
contentRating.author Text oder Organization Erforderlich, wenn contentRating Rating verwendet: Name der Rating-Agentur.
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.
popularityScore PopularityScoreSpecification Dringend empfohlene 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).
category Text Erforderlich, falls zutreffend – Füllen Sie diese Eigenschaft aus, wenn die Entität eine Movie-Variante ist. Legen Sie für category einen der folgenden Werte fest:
  • Home Release: Eine Version, die für zu Hause verkauft oder vermietet wird.
  • Theatrical Release: Eine im Kino veröffentlichte Version.
  • International Release: Eine Version, die für die internationale Veröffentlichung bearbeitet wurde.
  • Remastered: Eine Version, deren Bilder, Ton oder beides auf einen aktuelleren Standard verbessert wurden.
  • Unrated: Eine Version, die nicht von der MPAA oder einer ähnlichen Agentur überprüft wird.
  • Director Cut: Eine Version, die die vom Regisseur selbst genehmigte Änderung darstellt
  • Extended Cut: Eine Version, die länger ist als die im Kino.
workExample Film Gibt die Varianten des Films an. Füge dieses Attribut in die Movie-Hauptentität ein, nicht in die Movie-Entitäten für die Variantenversionen.
workExample.@id URL Bei Movie-Varianten stellt dieses Attribut die @id der Movie-Entität bereit, von der dies eine Variante ist.
workExample.@type Text Erforderlich: muss immer auf Movie gesetzt sein. Dies kann als Array für eine Movie mit mehreren Varianten dargestellt werden.
workExample.@id URL Erforderlich: Der @id der Variante Movie.
workExample.name Text Erforderlich: Der Name der Variante Movie.
workExample.category Text Erforderlich: Die Art der Filmvariante einer bestimmten Version. Legen Sie für die Kategorie eine der folgenden Optionen fest:
  • Home Release: Eine Version, die für zu Hause verkauft oder vermietet wird.
  • Theatrical Release: Eine im Kino veröffentlichte Version.
  • International Release: Eine Version, die für die internationale Veröffentlichung bearbeitet wurde.
  • Remastered: Eine Version, deren Bilder, Ton oder beides auf einen aktuelleren Standard verbessert wurden.
  • Unrated: Eine Version, die nicht von der MPAA oder einer ähnlichen Agentur überprüft wird.
  • Director Cut: Eine Version, die die vom Regisseur selbst genehmigte Änderung darstellt
  • Extended Cut: Eine Version, die länger ist als die 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"
  }
}

Variante des erweiterten Schnitts

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 Informationen zu Themen im Zusammenhang mit diesen Properties: