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"}]
|
@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:
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:
urlTemplate Property des Zielobjekts. |
name |
Text | Erforderlich : Der Name des Films.
|
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.
|
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:
|
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.
|
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:
|
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:
|
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:
|
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
Auf den folgenden Seiten finden Sie Informationen zu den Themen, die mit diesen Properties zusammenhängen: