Diese Seite wurde von der Cloud Translation API übersetzt.

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 mit Suchbegriffen sein, die den Inhalt beschreiben.
`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	Empfohlen – Erforderlich 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	Empfohlen – Erforderlich 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. Verwenden Sie ein Array, um die Beschreibung in mehreren Sprachen auszuzeichnen. Sehen Sie sich das Beispiel Mehrere Regionen und Sprachen an.
`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`	Organisation	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. Standardmäßig ist dieses Attribut 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"
}

Weitere Informationen

Auf den folgenden Seiten finden Sie Informationen zu Themen im Zusammenhang mit diesen Properties: