Inhalts-Markup-Eigenschaften von Filmen

In diesem Abschnitt finden Sie Details zu den Eigenschaften der Inhaltsauszeichnung 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 muss „@language“ auf den entsprechenden Sprachcode im BCP 47-Format gesetzt sein. Wenn die Sprache beispielsweise auf Spanisch festgelegt ist, wird davon ausgegangen, dass die Namen auf Spanisch sind, auch wenn die Untertitel-/Synchronisationssprache Englisch ist.
@type Text Erforderlich : Für Filme immer auf Movie gesetzt.
@id URL Erforderlich : Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Weltweit eindeutig in Ihrem Katalog
  • Statisch: Die ID sollte stabil sein und sich im Laufe der Zeit nicht ändern (auch wenn sich die URL-Property der Sendung ändert). Sie wird als undurchsichtiger String behandelt und muss kein funktionierender Link sein.
  • Im Format eines Unified Resource Identifier (URI)
  • Die für den Wert „@id“ 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, mit der Google den Inhalt in Ihrem Feed mit dem Inhalt in den Google-Datenbanken abgleicht.
url muss die folgenden Anforderungen erfüllen:
  • url muss weltweit eindeutig sein.
  • url muss eine funktionierende kanonische URL enthalten, die von Google gecrawlt werden kann.
Den Deeplink für die Wiedergabe finden Sie stattdessen in der urlTemplate Property des Zielobjekts.
name Text Erforderlich : Der Name des Films.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Weitere Informationen finden Sie im Beispiel für mehrere Regionen und Sprachen.
  • Beachten Sie, dass pro Gebietsschema (Sprach-Länder-Paar) nur ein Name unterstützt wird.
titleEIDR Text Sehr empfehlenswert Warum? - Eine EIDR-Kennung (Entertainment Identifier Registry), die auf der allgemeinsten/abstraktsten Ebene ein Film- oder Fernsehwerk darstellt.

Beispiel: Die titleEIDR für den Film „Ghostbusters“ ist „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.

Beispiel: Der Film „Ghostbusters“ mit der titleEIDR „10.5240/7EC7-228A-510A-053E-CBB8-J“ hat 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“ angegeben wird.
potentialAction WatchAction Erforderlich, falls zutreffend : Ein Action-Auszeichnungsobjekt, das die Details der Aktion enthält.
  • Wenn der Inhalt auf Video-on-Demand-Plattformen (VoD) verfügbar ist, ist diese Property erforderlich. Das Action-Auszeichnungsobjekt muss den Deeplink des Inhalts enthalten.
  • Wenn der Inhalt auf einem Live-TV-Kanal verfügbar ist, ist diese Property optional. Stattdessen enthält die zugehörige BroadcastService-Entität den Deeplink des Kanals.
  • Ein Movie kann sowohl auf VoD-Plattformen als auch im Live-TV verfügbar sein.
Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Weitere Informationen finden Sie im 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. Diese muss sich von der Property url unterscheiden.
inLanguage Text Sehr empfehlenswert : Die Originalsprache des Films im BCP 47-Format.
genre Text Eine geordnete 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. Beispiel: ["feature, biography"] kann 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 Herausgeber angegeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Verwenden Sie außerdem FeaturedEvent, um anzugeben, dass Ihr Dienst diesen Inhalt als Original, Featured, Special usw. vermarktet.

ExclusiveEvent gibt an, dass Ihr Dienst über exklusive Vertriebsrechte verfügt, und enthält Angaben dazu, wo und wann.

Weitere Informationen und Beispiele finden Sie im Beispielabschnitt.
releasedEvent.@type Text Erforderlich : Setzen Sie diese Property immer auf einen der folgenden Werte:
  • 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 der Inhalt veröffentlicht wurde.

Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der der Inhalt als Featured oder exklusiv verfügbar ist.

Verwenden Sie ISO 3166-Codes für Länder. Wenn Sie „überall“ angeben möchten, setzen Sie den Wert auf EARTH.
releasedEvent.startDate Datum oder DateTime Empfohlen : Erforderlich für ExclusiveEvent : Das Startdatum der Veröffentlichung der Entität.

Bei einem PublicationEvent gibt dies das ursprüngliche Veröffentlichungsdatum dieser Entität an, 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 als Featured verfügbar ist.
releasedEvent.endDate Datum oder DateTime Empfohlen : Erforderlich für ExclusiveEvent : Dies gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

Bei ExclusiveEvent ist dies das Datum, an dem die Rechte an den Inhalten ablaufen.

Bei FeaturedEvent ist dies das letzte Datum, an dem der Anbieter die Entität als Featured anbietet.

Wenn der Inhalt dauerhaft exklusiv oder als Featured verfügbar ist, setzen Sie 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 Sehr empfehlenswert Warum? Eine Zusammenfassung des Films. Zusammenfassungen der Handlung sind faktischen Zusammenfassungen vorzuziehen. Beschränkung auf 300 Zeichen.
  • Verwenden Sie ein Array, um die Beschreibung in mehreren Sprachen auszuzeichnen. Weitere Informationen finden Sie im Beispiel für mehrere Regionen und Sprachen.
duration Dauer Laufzeit des Films im ISO 8601-Format. Verwenden Sie das Format „PT00H00M“.
director Person Sehr empfehlenswert Warum? Der/die Regisseur(e) des Films.
actor Person Sehr empfehlenswert Warum? Die Schauspieler des Films.
producer Organisation oder Person Sehr empfehlenswert Warum? Der/die Produzent(en) des Films.
image ImageObject Erforderlich für Google TV : Die Bilder im Zusammenhang mit dem Film. Weitere Informationen zu den erforderlichen und optionalen Properties, die mit image verwendet werden müssen, finden Sie unter Image-Properties.
trailer.description Text Die Beschreibung des Trailers. Weitere Informationen finden Sie im Trailer-Beispiel.
trailer.inLanguage Text Sehr empfehlenswert : 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 nichts angegeben ist, wird davon ausgegangen, dass sie überall zulässig sind. Geben Sie die Länder im ISO 3166-Format an.
identifier PropertyValue Sehr empfehlenswert Warum? - Externe oder sonstige ID, durch die diese Entität eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt Identifier-Properties.
review Rezension Rezensionsbewertungen für den Film
review.reviewRating Bewertung Erforderlich, wenn eine Rezension angegeben wird. Damit wird die in der Rezension abgegebene Bewertung angegeben.
contentRating Text oder Bewertung Erforderlich für Inhalte für Erwachsene, ansonsten sehr empfehlenswert Warum? Altersfreigabe des Inhalts. Wenn die Altersfreigabe in Form eines Textstrings angegeben wird, sind zwei Varianten zulässig:
  • Die Altersfreigabeagentur vor der Altersfreigabe, getrennt durch ein Leerzeichen. Beispiel: Eine „PG-13“-Altersfreigabe der Agentur „MPAA“ in den USA sollte als „MPAA PG-13“ beschrieben werden. Siehe die Liste der Agenturen.
  • Der Wert „RATING NOT KNOWN“ (Groß-/Kleinschreibung wird nicht beachtet), um anzugeben, dass Sie die Altersfreigabe für den Film nicht kennen.
contentRating.author Organisation Erforderlich, wenn contentRating für Rating verwendet wird : Der Name der Altersfreigabeagentur.
contentRating.ratingValue Text Erforderlich, wenn für contentRating Rating verwendet wird : Der Wert der Altersfreigabe.
contentRating.advisoryCode Text Der Hinweiscode für den Inhalt. Zulässige Werte sind „D“, „FV“, „L“, „S“ und „V“. „D“ = Dialog, „FV“ = Fantasy Violence (Gewalt in Fantasy-Filmen), „L“ = Language (Sprache), „S“ = Sexual Content (Sexuelle Inhalte), „V“ = Violence (Gewalt).
popularityScore PopularityScoreSpecification Sehr empfehlenswert Warum? Eine Bewertung, die Google zusammen mit anderen Signalen verwendet, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden sollen. Diese Bewertung gibt die Beliebtheit des Inhalts im Verhältnis zu anderen Inhalten in Ihrem Katalog an. Daher muss die Skala der Bewertung in allen Feeds und für alle Entitäten in Ihrem Katalog einheitlich sein. Standardmäßig ist die Beliebtheitsbewertung einer Entität auf 0 gesetzt.
popularityScore.@type Text Immer auf PopularityScoreSpecification gesetzt.
popularityScore.value Number Ein nicht negativer numerischer Wert, der die Beliebtheit der Entität angibt. Je höher die Bewertung, desto beliebter ist die Entität.
popularityScore.eligibleRegion Land Region(en), in denen diese Beliebtheitsbewertung gilt. Wenn die Beliebtheitsbewertung weltweit gilt, setzen Sie den Wert auf EARTH. Standardmäßig ist diese Property auf EARTH gesetzt.
Note: Hinweis: Die gebietsschemaspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH).
category Text Erforderlich, falls zutreffend : Füllen Sie diese Property aus, wenn die Entität eine Movie Variante ist. Setzen Sie category auf einen der folgenden Werte:
  • Home Release: Eine Version, die für die Wiedergabe zu Hause verkauft oder verliehen wird.
  • Theatrical Release: Eine Version, die in den Kinos 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 einen aktuelleren Standard verbessert wurden.
  • Unrated: Eine Version, die nicht von der MPAA oder einer ähnlichen Agentur geprüft wurde.
  • Director Cut: Eine Version, die die vom Regisseur genehmigte Bearbeitung darstellt.
  • Extended Cut: Eine Version, die länger als die Kinofassung ist.
workExample Film Gibt die Varianten des Films an. Fügen Sie diese Property in die Hauptentität Movie ein, nicht in die Movie-Entitäten für die Varianten.
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. Für einen Movie mit mehreren Varianten kann dies als Array 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. Setzen Sie die Kategorie auf einen der folgenden Werte:
  • Home Release: Eine Version, die für die Wiedergabe zu Hause verkauft oder verliehen wird.
  • Theatrical Release: Eine Version, die in den Kinos 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 einen aktuelleren Standard verbessert wurden.
  • Unrated: Eine Version, die nicht von der MPAA oder einer ähnlichen Agentur geprüft wurde.
  • Director Cut: Eine Version, die die vom Regisseur genehmigte Bearbeitung 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"
}

Auf den folgenden Seiten finden Sie Informationen zu den Themen, die mit diesen Properties zusammenhängen: