Diese Seite wurde von der Cloud Translation API übersetzt.

Inhalts-Markup-Eigenschaften von Filmen

In diesem Abschnitt finden Sie Details zu den Inhalts-Markup-Properties für den Entitätstyp Movie.

Tabelle mit Spezifikationen

Attribut	Erwarteter Typ	Beschreibung
`@context`	Text	Erforderlich: Muss immer auf `["http://schema.org", {"@language": "xx"}]` gesetzt sein. Dabei steht „xx“ für die Sprache der Strings im Feed. Für jeden Stammentitätskontext 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 Sprache der Untertitel oder Synchronisation Englisch ist.
`@type`	Text	Erforderlich: Muss für Filme immer auf `Movie` gesetzt sein.
`@id`	URL	Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc. `@id` muss die folgenden Anforderungen erfüllen: Sie muss in Ihrem gesamten Katalog eindeutig sein. Statisch: Die ID muss 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 eines Uniform Resource Identifiers (URI) Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören. Da die `url` einer Entität alle Anforderungen als 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 der Inhalte, anhand derer Google die Inhalte in Ihrem Feed mit den Inhalten in den Google-Datenbanken abgleicht. `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 findest du stattdessen im Attribut `urlTemplate` des Ziel-Objekts.
`name`	Text	Erforderlich: Der Name des Films. Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Siehe Beispiel Mehrere Regionen und Sprachen. Pro Sprache und Land wird nur ein Name unterstützt.
`titleEIDR`	Text	Empfohlen Warum? – Eine EIDR (Entertainment Identifier Registry), die auf der allgemeinsten/abstraktesten Ebene ein Film- oder Fernsehwerk darstellt. Die titleEIDR für den Film „Ghostbusters“ lautet beispielsweise „10.5240/7EC7-228A-510A-053E-CBB8-J“.
`editEIDR`	Text	Empfohlen Warum? – Eine EIDR (Entertainment Identifier Registry), die eine bestimmte Fassung eines Films oder einer Fernsehsendung darstellt. Der Film „Ghostbusters“, dessen TitleEIDR „10.5240/7EC7-228A-510A-053E-CBB8-J“ lautet, hat beispielsweise mehrere Fassungen, 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	Falls zutreffend erforderlich: Ein Aktions-Markup-Objekt mit den Details der Aktion. Wenn die Inhalte als Video-on-Demand (VoD) verfügbar sind, ist diese Property erforderlich. Das Action-Markup-Objekt muss den Deeplink zu den Inhalten enthalten. Wenn die Inhalte auf einem LiveTV-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 bei VoD als auch bei Live-TV verfügbar sein. Verwenden Sie ein Array, um verschiedene Deeplinks in mehreren Regionen anzugeben. Siehe Beispiel Mehrere Regionen und Sprachen.
`sameAs`	URL	Empfohlen Warum? Die URL einer Referenz-Webseite, anhand derer der Film identifiziert werden kann, z. B. die Wikipedia-Seite des Films. Dieser 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	Keywords oder Tags, die zur Beschreibung dieser Inhalte verwendet werden. Auch ein Array von Keywords ist zulässig. [„feature, biography“] kann beispielsweise ein Array von Keywords sein, um die Inhalte zu beschreiben.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` oder `ExclusiveEvent`	Empfohlen 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, als empfohlen, als Sonderangebot usw. bewirbt. `ExclusiveEvent` gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Informationen zu Ort und Zeitpunkt. Details und Beispiele findest du im Beispielbereich.
`releasedEvent.@type`	Text	Erforderlich: Diese Eigenschaft muss immer auf eine der folgenden Optionen festgelegt werden: `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 oder exklusiv verfügbar sind. Verwende ISO 3166-Codes für Länder. Wenn Sie alle Regionen der Welt einbeziehen möchten, geben Sie `EARTH` ein.
`releasedEvent.startDate`	Datum oder DateTime	Empfohlen – Erforderlich für `ExclusiveEvent`: Das Startdatum der Veröffentlichung der Entität. Bei einer `PublicationEvent` gibt dies das Datum der Erstveröffentlichung dieser Entität an, z. B. das Datum, an dem ein Film erstmals in den Kinos gezeigt wurde. Bei `ExclusiveEvent` und `FeaturedEvent` ist dies das Startdatum, ab dem die Entität exklusiv oder als „Empfohlen“ gekennzeichnet ist.
`releasedEvent.endDate`	Datum oder DateTime	Empfohlen – Erforderlich für `ExclusiveEvent` – Diese Angabe 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 das Rechtssubjekt präsentiert. Wenn die Inhalte zeitlich unbegrenzt exklusiv oder vorgestellt werden, legen Sie `endDate` auf 20 Jahre ab dem aktuellen Datum fest.
`releasedEvent.publishedBy`	Organisation oder Person	Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
`description`	Text	Empfohlen Warum? Eine Zusammenfassung des Films. Plot-Synopsen werden Sachzusammenfassungen vorgezogen. Die maximale Zeichenanzahl beträgt 300. Verwenden Sie ein Array, um die Beschreibung in mehreren Sprachen zu markieren. Siehe Beispiel Mehrere Regionen und Sprachen.
`duration`	Dauer	Die Laufzeit des Films im ISO 8601-Format. Verwenden Sie das Format „PT00H00M“.
`director`	Person	Empfohlen Warum? Die Regisseure des Films.
`actor`	Person	Empfohlen Warum? Die Darsteller des Films.
`producer`	Organisation oder Person	Empfohlen Warum? Die Produzenten des Films.
`image`	ImageObject	Für Google TV erforderlich: Die Bilder, die sich auf den Film beziehen. Weitere Informationen zu den erforderlichen und optionalen Properties, die Sie in `image` einschließen sollten, finden Sie unter Bild-Properties.
`trailer.description`	Text	Die Beschreibung des Trailers. 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 wurde.
`trailer.regionsAllowed`	Ort	Die Regionen, in denen die Medien zulässig sind. Wenn keine Region angegeben wird, wird davon ausgegangen, dass das Video überall zulässig ist. Gib die Länder im ISO 3166-Format an.
`identifier`	PropertyValue	Empfohlen 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 ID-Attribute.
`review`	Rezension	Rezensionsbewertungen für den Film
`review.reviewRating`	Bewertung	Erforderlich, wenn eine Rezension vorhanden ist. Hier wird die in der Rezension angegebene Bewertung angegeben.
`contentRating`	Text oder Altersfreigabe	Erforderlich für Inhalte nur für Erwachsene, ansonsten dringend empfohlen Warum? – Allgemeine Altersfreigabe Wenn die Altersfreigabe in Form eines Textstrings angegeben ist, sind zwei Varianten zulässig: Die Ratingagentur hat der Bewertung ein Leerzeichen vorangestellt. Eine Altersfreigabe von „PG-13“ der US-amerikanischen „MPAA“ sollte beispielsweise als „MPAA PG-13“ beschrieben werden. Liste der Agenturen „RATING NOT KNOWN“ (NICHT KENNTN) (ohne Berücksichtigung der Groß- und Kleinschreibung), um anzugeben, dass du die Altersfreigabe für den Film nicht kennst.
`contentRating.author`	Organisation	Erforderlich, wenn `contentRating` `Rating` verwendet: Der Name der Altersfreigabestelle.
`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, L = Language, S = Sexual Content, V = Violence.
`popularityScore`	PopularityScoreSpecification	Empfohlen Warum? Ein Wert, der zusammen mit anderen Signalen von Google verwendet wird, um zu bestimmen, welche Medien für Nutzer wiedergegeben werden. Dieser Wert gibt die Beliebtheit der Inhalte im Vergleich zu anderen Inhalten in deinem Katalog an. Daher muss die Skala für die Bewertung in allen Feeds und für alle Entitäten in deinem Katalog einheitlich sein. Standardmäßig ist der Beliebtheitswert einer Entität auf 0 gesetzt.
`popularityScore.@type`	Text	Immer auf `PopularityScoreSpecification` gesetzt.
`popularityScore.value`	Number	Ein nicht negativer numerischer Wert, der die Beliebtheit des Elements angibt. Je höher der Wert, desto beliebter ist das Element.
`popularityScore.eligibleRegion`	Land	Regionen, in denen dieser Beliebtheitsrang gilt. Wenn der Beliebtheitsfaktor global gilt, legen Sie `EARTH` fest. Standardmäßig ist diese Eigenschaft auf `EARTH` eingestellt. `Note:` Die länderspezifische Beliebtheit hat Vorrang vor der globalen Beliebtheit (EARTH)
`category`	Text	Falls zutreffend erforderlich: 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 Wiedergabe zu Hause 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 einen aktuelleren Standard verbessert wurde. `Unrated`: Eine Version, die nicht von der MPAA oder einer ähnlichen Behörde geprüft wurde. `Director Cut`: Eine Version, die die genehmigte Fassung des Regisseurs 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 dem Hauptobjekt vom Typ `Movie` hinzu, nicht den `Movie`-Objekten für die Variantenversionen.
`workExample.@id`	URL	Bei `Movie`-Varianten gibt dieses Attribut den `@id` der `Movie`-Entität an, deren Variante dies 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: Die `@id` der `Movie`-Variante.
`workExample.name`	Text	Erforderlich: Der Name der `Movie`-Variante.
`workExample.category`	Text	Erforderlich: Die Art der Filmvariante einer bestimmten Version. Legen Sie eine der folgenden Kategorien fest: `Home Release`: Eine Version, die für die Wiedergabe zu Hause 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 einen aktuelleren Standard verbessert wurde. `Unrated`: Eine Version, die nicht von der MPAA oder einer ähnlichen Behörde geprüft wurde. `Director Cut`: Eine Version, die die genehmigte Fassung des Regisseurs darstellt. `Extended Cut`: Eine Version, die länger als die Kinofassung ist.

Beispiel

Hauptfilm

Ein Film mit einer erweiterten Schnittfassung.

{
  "@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 mit erweitertem Schnitt

Die erweiterte 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

Auf den folgenden Seiten finden Sie Informationen zu diesen Properties: