Inhalts-Markup-Eigenschaften von Filmen

In diesem Abschnitt finden Sie Details zu den Eigenschaften der Inhaltskennzeichnung für den Entitätstyp Movie.

Spezifikationstabelle

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: Muss für Filme immer auf `Movie` gesetzt werden.
`@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 Statisch: Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich das Attribut „url“ der Show ä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 des Films. Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Beispiel für mehrere Regionen und Sprachen Pro Sprache und Land wird nur ein Name unterstützt.
`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 den Film „Ghostbusters“ lautet beispielsweise „10.5240/7EC7-228A-510A-053E-CBB8-J“.
`editEIDR`	Text	Sehr empfehlenswert Warum? – Eine EIDR-Kennung (Entertainment Identifier Registry), die eine bestimmte Bearbeitung / Ausgabe eines Film- oder Fernsehwerks darstellt. Der Film „Ghostbusters“ mit der Titel-EIDR „10.5240/7EC7-228A-510A-053E-CBB8-J“ hat beispielsweise mehrere Bearbeitungen, z.B. „10.5240/1F2A-E1C5-680A-14C6-E76B-I“ und „10.5240/8A35-3BEE-6497-5D12-9E4F-3“. Die Property `titleEIDR` ist erforderlich, wenn „editEIDR“ angegeben wird.
`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 `Movie` 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, die den Film identifizieren kann, z. B. die Wikipedia-Seite des Films. Muss sich von der Property `url` unterscheiden.
`inLanguage`	Text	Sehr empfehlenswert: Die Originalsprache des Films 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 des Films. Handlungszusammenfassungen werden gegenüber sachlichen Zusammenfassungen bevorzugt. Max. 300 Zeichen. Verwenden Sie ein Array, um die Beschreibung in mehreren Sprachen zu kennzeichnen. Beispiel für mehrere Regionen und Sprachen
`duration`	Dauer	Die Laufzeit des Films im ISO 8601-Format. Verwenden Sie das Format „PT00H00M“.
`director`	Person	Sehr empfehlenswert Warum? Der oder die Regisseure des Films.
`actor`	Person	Sehr empfehlenswert Warum? Die Schauspieler des Films.
`producer`	Organization oder Person	Sehr empfehlenswert Warum? Die Produzenten des Films.
`image`	ImageObject	Erforderlich für Google TV: Die Bilder, die sich auf den Film 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).
`review`	Rezension	Bewertungen für den Film ansehen
`review.reviewRating`	Bewertung	Erforderlich, wenn eine Rezension angegeben wird. Damit wird die in der Rezension abgegebene Bewertung angegeben.
`contentRating`	Text oder Altersfreigabe	Für Inhalte für Erwachsene erforderlich, ansonsten dringend empfohlen Warum? – Gesamtbewertung für 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 „PG-13“ der MPAA in den USA sollte als „MPAA PG-13“ angegeben werden. Liste der Agenturen Der Wert „RATING NOT KNOWN“ (Groß-/Kleinschreibung wird nicht beachtet) gibt an, dass Sie die Altersfreigabe für den Film nicht kennen.
`contentRating.author`	Organisation	Erforderlich, wenn `contentRating` `Rating` verwendet: Der Name der Ratingagentur.
`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).
`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
`category`	Text	Erforderlich, falls zutreffend: Geben Sie diese Property an, wenn es sich bei der Entität um eine `Movie`-Variante handelt. Legen Sie für `category` einen der folgenden Werte fest: `Home Release`: Eine Version, die für die private Nutzung verkauft oder verliehen 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 Organisation geprüft wurde. `Director Cut`: Eine Version, die den vom Regisseur selbst genehmigten Schnitt darstellt. `Extended Cut`: Eine Version, die länger als die Kinofassung ist.
`workExample`	Film	Gibt die Varianten des Films an. Nehmen Sie diese Property in das Hauptobjekt `Movie` auf, nicht in die `Movie`-Objekte für die Variantenversionen.
`workExample.@id`	URL	Für `Movie`-Varianten enthält diese Property die `@id` der `Movie`-Entität, von der diese Variante abgeleitet ist.
`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: Die `@id` der `Movie`-Variante.
`workExample.name`	Text	Erforderlich: Der Name der `Movie`-Variante.
`workExample.category`	Text	Erforderlich: Der Typ der Filmvariante einer bestimmten Version. Legen Sie die Kategorie auf einen der folgenden Werte fest: `Home Release`: Eine Version, die für die private Nutzung verkauft oder verliehen 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 Organisation geprüft wurde. `Director Cut`: Eine Version, die den vom Regisseur selbst genehmigten Schnitt darstellt. `Extended Cut`: Eine Version, die länger als die Kinofassung ist.

Beispiel

Hauptfilm

Ein Film mit einer Extended Cut-Variante.

{
  "@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"
  }
}

Extended Cut-Variante

Die Extended Cut-Version 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"
}

Weitere Informationen

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

Inhalts-Markup-Eigenschaften von Filmen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.