In diesem Abschnitt werden die Eigenschaften des Inhalts-Markups von image
für Filme und Serien beschrieben. Mit diesem Markup können Anbieter den Typ des Bildes beschreiben, z. B. ob es sich um ein Bild, einen Hintergrund oder ein legendäres Bild handelt, sowie die vorgeschlagene Verwendung.
Spezifikationstabelle
Das Attribut image
kann für die Entitätstypen Movie
, TVSeries
, TVSeason
oder TVEpisode
angegeben werden. In der folgenden Tabelle werden die verfügbaren Attribute für das Attribut image
beschrieben. Beachten Sie, dass das Attribut additionalProperty
einen benutzerdefinierten Attributnamen namens contentAttributes
enthält. Dieser enthält ein Array von Werten, die den Typ des Bildes und dessen beabsichtigte Verwendung beschreiben.
Attribut | Erwarteter Typ | Beschreibung |
---|---|---|
@context |
Text | Erforderlich: Immer auf "http://schema.org" gesetzt. |
@type |
Text | Erforderlich: Immer auf ImageObject gesetzt. |
contentUrl |
URL | Erforderlich: Die URL des Bilds. |
additionalProperty |
PropertyValue | Erforderlich: Definiert die Property contentAttributes , die den Image-Typ und seine beabsichtigte Verwendung beschreibt. Weitere Informationen finden Sie unter contentAttributes . |
character |
Person |
Erforderlich, wenn zutreffend: Ein fiktives Zeichen, das dem Bild zugeordnet ist. Dies ist erforderlich, wenn |
inLanguage |
Text | Erforderlich, falls zutreffend: die im Bild verwendete Sprache Verwende einen der Sprachcodes aus dem IETF BCP 47-Standard.
Wenn das Bild einen contentAttribute von hasTitle enthält, ist dieses Attribut erforderlich. |
regionsAllowed |
Ort | Empfohlen: Die Regionen, in denen das Image zulässig ist. Wenn kein Wert angegeben wird, wird davon ausgegangen, dass das Image überall zulässig ist. Gib die Länder im ISO 3166-Format an. |
datePublished |
Datum | Erforderlich, falls zutreffend – Datum, nach dem das Bild verfügbar ist, im ISO 8601-Format (einschließlich Zeitzone).
Wenn es zeitliche Einschränkungen für die Nutzung des Images gibt, ist diese Property erforderlich, wenn das Image nicht vor dem angegebenen Datum angezeigt werden darf. Wenn keine solche Einschränkung vorhanden ist, kann sie weggelassen werden. Das entsprechende Bild muss im Feed mindestens 7 Tage vor dem Datum der Veröffentlichung angegeben werden. Das erhöht die Chancen, dass die Inhalte rechtzeitig auf Google-Plattformen angezeigt werden. |
expires |
Datum | Erforderlich, falls zutreffend – Datum, nach dem das Image nicht mehr verfügbar ist. Die Angabe erfolgt im ISO 8601-Format, einschließlich der Zeitzone.
Aktualisierungen am Ablaufdatum müssen mindestens 7 Tage vor dem Ablaufdatum im Feed vorgenommen werden. Dadurch wird die Wahrscheinlichkeit erhöht, dass die Inhalte ab dem Ablaufdatum nicht mehr auf Google-Plattformen angezeigt werden. |
audience |
Zielgruppe | Empfohlen: Die beabsichtigte oder bevorzugte Zielgruppe für dieses Bild. |
audience.geographicArea |
Verwaltungsgebiet | Empfohlen: Hier sehen Sie die vorgesehenen oder bevorzugten Regionen für dieses Bild.
Mit regionsAllowed können Sie feste Einschränkungen festlegen. Wenn audience.geographicArea nicht angegeben ist, wird davon ausgegangen, dass es überall verwendet werden kann. Gib die Länder im ISO 3166-Format an. |
copyrightHolder |
Organisation oder Person | Empfohlen: Die Partei, die das Urheberrecht an dem Bild hat. |
keywords |
Text | Empfohlen: Suchbegriffe oder Tags zur Beschreibung des Bildes.
Mit einem Array können mehrere keywords angegeben werden. Beispiel: ["Funktion, Biografie"] |
name |
Text | Empfohlen: Name des Bilds. |
contentAttributes
Mit dem Attribut contentAttributes
von image
wird der Typ des Bildes beschrieben und dessen vorgeschlagene Verwendung definiert. Die Kategorien in der folgenden Liste enthalten die contentAttributes
-Werte, die Anbieter für jeden ImageObject
-Wert angeben müssen.
Typ
iconic
: Ein illustratives Bild, das die Sendung veranschaulicht. Oft ist es ein künstlerisches Rendering.sceneStill
: Ein Bildauszug aus der Sendung.castInCharacter
: Ein Foto von einem Mitwirkenden, wie es im Film zu sehen ist. Wenn Sie diesen Wert verwenden, fügen Sie auch die Propertycharacter
ein, um das jeweilige Zeichen im Bild zu identifizieren. Wenn mehrere Zeichen vorhanden sind, z. B. in einem Cast-Ensemble, schließe mehrerecharacter
-Attribute als Array ein.logo
: Das Bild enthält nur ein Logo. Dies kann entweder ein grafisches Logo oder ein Titellogo sein. Geben Sie das entsprechende Overlay an, um anzugeben.
Verwenden Sie einen der folgenden Typen, um gültig zu sein.
Empfohlene Verwendung
poster
: Ein Posterbild für die Sendung. Auf Computer-UIs können sie in Karussells verwendet werden. Sie können den Titel der Sendung enthalten.background
: Ein Bild, das als Hintergrund mit Text- oder UI-Overlays verwendet werden kann Diese Bilder enthalten keinen Text.
Geben Sie höchstens eine der empfohlenen Verwendungen an, um gültig zu sein.
Größeneignung
smallFormat
: Ein Bild, das für kleinere Bildschirme wie Smartphones geeignet ist. Alle Texte oder Logos im Bild sind auf einem kleinen Bildschirm gut lesbar.largeFormat
: Ein Bild, das für größere Bildschirme oder gedruckte Poster geeignet ist.
Für ein Bild können beide Werte verwendet werden.
Hintergrundeignung
forDarkBackground
: Ein Bild, in der Regel ein transparentes Logo, das auf einem dunklen Hintergrund verwendet werden kann.forLightBackground
: Ein Bild, normalerweise ein transparentes Logo, das sich vor einem hellen Hintergrund eignet.
Verwenden Sie zur Gültigkeit höchstens einen Wert für die Eignung für Inhalte im Hintergrund.
Overlays
hasTitle
: Der Titel der Sendung oder der Name der Figur oder des Akteurs im Bild. Achten Sie darauf, das AttributinLanguage
für das Bild anzugeben.noTitle
: Das Bild enthält keinen Titel.hasLogo
: Das Bild enthält das Logo eines Films, einer Serie, eines Rechteinhabers oder eines Vertriebspartners.noLogo
: Das Bild enthält kein Logo.hasCopyright
: Das Bild enthält einen deutlichen Urheberrechtshinweis.noCopyright
: Das Bild enthält keinen sichtbaren Urheberrechtshinweis. Google kann diese Bilder im Allgemeinen nicht ohne Änderung verwenden.hasMatte
: Das Bild ist matt. Das kann horizontal (Letterbox-Format), vertikal (Pillarbox-Bild) oder beides (Windowbox-Bild) sein. Manchmal sind Bilder mattiert, sodass sie in ein Seitenverhältnis passen. Google kann solche Bilder im Allgemeinen nicht ohne Änderung verwenden.noMatte
: Das Bild hat keine Matte.transparentBackground
: Der Hintergrund des Bildes ist transparent. Dies wird normalerweise für Bilder verwendet, die nur einen Titel oder ein Logo enthalten.
Zur Gültigkeit sind nur ein Titel, ein Logo, ein Urheberrecht und ein mattes Attribut zulässig.
Position einer vorherrschenden Figur
centered
: Die vorherrschende Figur wird in der Mitte des Bilds platziert.rightCentered
: Die vorherrschende Figur ist auf der rechten Seite des Bildes positioniert, sodass die linke Seite für Text- und UI-Overlays relativ leer bleibt.leftCentered
: Die vorherrschende Figur ist auf der linken Seite des Bildes positioniert, sodass die rechte Seite für Text- und UI-Overlays relativ leer bleibt.
Geben Sie zur Gültigkeit maximal eine dieser Positionen an.
Beispielbilder mit ihrer beabsichtigten Verwendung
Beispielbilder und ihre contentAttribute
Gewünschte Bildtypen für Google-Produkte
Verschiedene Google-Produkte und -Oberflächen erfordern unterschiedliche Bildtypen und Seitenverhältnisse. Damit Inhalte in allen Google-Produkten korrekt angezeigt werden, müssen Anbieter alle Bildtypen aus der folgenden Tabelle angeben.
Seitenverhältnis und contentAttribute | Mindestauflösung (Pixel) | Film | Serie | Serienstaffel | Serienfolge | Übertragungsdienst |
---|---|---|---|---|---|---|
16:99 iconic poster |
3.840 x 2.160 | |||||
2:3, iconic poster |
1000x1500 | |||||
4:3, iconic poster |
800 x 600 | |||||
1:1, iconic poster |
600x600 | |||||
3:4, |
600x800 | |||||
16:9, |
3.840 x 2.160 | |||||
2:3, |
1000x1500 | |||||
3:4, |
600x800 | |||||
1:1, Logo anzeigen (hasLogo ) |
600x600 | |||||
4:3, Kanallogo (logo ) |
800 x 600 | |||||
1:1, Kanallogo (logo ) |
600x600 | |||||
16:9, Kanal-Logo (logo ) |
3.840 x 2.160 | |||||
9:5, |
1800 × 1000 |
Beim Einreichen von Bildern gelten die folgenden Richtlinien:
- Die Bilder müssen das Format JPEG, PNG oder WebP haben.
- Verwende die Bilder mit der höchsten Auflösung.
- Die Datei darf nicht größer als 20 MB sein.
centered
Bilder werden bevorzugt. Bei einigen Produkten können auch Hintergrundbilder vom TyprightCentered
undleftCentered
verwendet werden. Sie können also solche Bilder aufnehmen, wenn sie vorhanden sind.- Wir bevorzugen Bilder, die für
smallFormat
undlargeFormat
funktionieren. - Sie können zusätzlich zu den in der vorherigen Tabelle aufgeführten Bildgrößen verwenden.
- Achten Sie darauf, dass das Seitenverhältnis jedes Bildes einer der allgemeinen Werte ist, die in der vorherigen Tabelle aufgeführt sind. Andernfalls wird eine Warnung ausgegeben.
Beispielbilder mit Schema
Die folgenden Beispiele zeigen, wie das Schema für Bilder formatiert wird, die mit Filmen oder Serien verknüpft sind.
Filmhintergrundbild mit zwei Zeichen
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/mountain_view",
"url": "http://www.example.com/my_favorite_movie",
...,
"image": {
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Mountain View: A Movie poster",
"Keywords": ["Mauren, Lord Wingflap the Destroyer"],
"contentUrl": "http://example.com/images/mountain-view.jpg",
"character": [
{ "@type": "Person", "name": "Mauren" },
{ "@type": "Person", "name": "Lord Wingflap the Destoyer" },
],
"copyrightHolder": {
"@type": "Organization",
"name": " ExampleOrganization Studios, Inc."
},
"inLanguage": "en-US",
"audience": {
"@type": "Audience",
"geographicArea": [{"@type": "Country", "name": "US"},
{"@type": "Country", "name": "GB"},
{"@type": "Country", "name": "CA"},
{"@type": "Country", "name": "AU"}]
},
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
"noCopyright", "noMatte", "smallFormat", "largeFormat"]
}
]
}
}
Hintergrundbild der TV-Serie auf zwei Regionen beschränkt
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "TVSeries",
"@id": "http://www.example.com/mountain_view",
"url": "http://www.example.com/mountain_view",
...,
"image": {
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Mountain View: A TV Show",
"contentUrl": "http://example.com/images/mountain-view.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": "en-US",
"regionsAllowed": [{ "@type": "Country", "name": "US" },
{ "@type": "Country", "name": "GB" }],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "background", "rightCentered", "smallFormat",
"largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
}
]
}
}
Filmposterbild, das für zwei Regionen vorgesehen ist
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/pulsar_quest",
"url": "http://www.example.com/pulsar_quest",
...,
"image": {
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier",
"contentUrl": "http://example.com/images/pulsar-quest.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": "en-US",
"audience": [{ "@type": "Country", "name": "US" },
{ "@type": "Country", "name": "GB" }],
"character": [
{
"@type": "Person",
"name": "Captain Pulsar"
}
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle",
"hasLogo", "noCopyright", "noMatte", "centered"]
}
]
}
}
Großformatiges Filmposter mit koreanischen und englischen Inhalten
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/pulsar_quest",
"url": "http://www.example.com/pulsar_quest",
...,
"image": {
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": ["kr", "en"],
"audience": { "@type": "Country", "name": "KR" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" },
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
}
}
Mehrere Bilder pro Region
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/pulsar_quest",
"url": "http://www.example.com/pulsar_quest",
...,
"image": [{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest-us.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": ["en"],
"audience": { "@type": "Country", "name": "US" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" }
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
},{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"inLanguage": ["kr"],
"audience": { "@type": "Country", "name": "KR" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" }
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
}]
}
Zeitlich begrenzte Bilder darstellen
{
"@context": [ "http://schema.org", { "@language": "en" } ],
"@type": "Movie",
"@id": "http://www.example.com/pulsar_quest",
"url": "http://www.example.com/pulsar_quest",
...,
"image": [{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest-jp.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"datePublished": "2022-10-31T17:00:00Z",
"expires": "2025-10-31T16:59:59Z",
"inLanguage": ["ja"],
"audience": { "@type": "Country", "name": "JP" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" }
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
},{
"@context": "http://schema.org",
"@type": "ImageObject",
"name": "Pulsar Quest: A New Frontier poster",
"contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
"copyrightHolder": {
"@type": "Organization",
"name": "ExampleOrganization Studios, Inc."
},
"datePublished": "2021-10-31T17:00:00Z",
"expires": "2023-10-31T16:59:59Z",
"inLanguage": ["kr"],
"audience": { "@type": "Country", "name": "KR" },
"character": [
{ "@type": "Person", "name": "Captain Pulsar" },
{ "@type": "Person", "name": "Space Cadet Shaniah" },
{ "@type": "Person", "name": "Rove the Rover" }
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "contentAttributes",
"value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered"]
}
]
}]
}