Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Propriétés d'image

Cette section détaille les propriétés de balisage de contenu de image pour les films, les séries TV, les émissions de télévision en direct et les événements sportifs. Ce balisage permet aux fournisseurs de décrire le type d'image (par exemple, s'il s'agit d'un titre, d'un arrière-plan ou d'une image emblématique) et l'utilisation suggérée.

Table de spécification

La propriété image peut être fournie pour les types d'entités Movie, TVSeries, TVSeason, TVEpisode, SportsEvent ou BroadcastEvent. Le tableau suivant décrit les propriétés disponibles pour la propriété image. Notez que la propriété additionalProperty inclut un nom de propriété personnalisée appelé contentAttributes, qui contient un tableau de valeurs décrivant le type d'image et son utilisation prévue.

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : toujours défini sur `"http://schema.org"`.
`@type`	Texte	Obligatoire : toujours défini sur `ImageObject`.
`contentUrl`	URL	Obligatoire : URL de l'image.
`additionalProperty`	PropertyValue	Obligatoire : définit la propriété `contentAttributes`, qui décrit le type d'image et son utilisation prévue. Pour en savoir plus, consultez `contentAttributes`.
`character`	Personne	Obligatoire, le cas échéant : personnage fictif associé à l'image. Cette option est obligatoire si `contentAttribute` inclut `castInCharacter`. Remarque : Vous pouvez utiliser le type `Person` ici, même si le personnage n'est pas humain.
`inLanguage`	Texte	Obligatoire, le cas échéant : langue du texte utilisé dans l'image. Utilisez l'un des codes de langue de la norme IETF BCP 47. Si l'image inclut un `contentAttribute` de `hasTitle`, cette propriété est obligatoire.
`regionsAllowed`	Place	Recommandé : régions dans lesquelles l'image est autorisée. Si cette information n'est pas spécifiée, l'image est considérée comme autorisée partout. Spécifiez les pays au format ISO 3166.
`datePublished`	Date	Obligatoire, le cas échéant : date après laquelle l'image est disponible, au format ISO 8601 (fuseau horaire inclus). La date peut être définie dans le futur. Si l'utilisation de l'image est soumise à des restrictions temporelles, cette propriété est obligatoire si l'image ne doit pas être affichée avant la date indiquée. Si aucune restriction de ce type n'existe, elle peut être omise. L'image correspondante doit être fournie dans le flux au moins sept jours avant sa date de publication (datePublished). Cela augmentera les chances que le contenu s'affiche à temps sur les surfaces Google.
`expires`	Date	Obligatoire, le cas échéant : date après laquelle l'image n'est plus disponible, au format ISO 8601 (fuseau horaire compris). Si le contenu est toujours disponible après sa publication, vous pouvez omettre cette propriété. Toute modification de la date d'expiration doit être effectuée dans le flux au moins sept jours avant la date d'expiration. Cela augmentera les chances que le contenu cesse d'apparaître sur les surfaces Google à la date d'expiration.
`audience`	Audience	Recommandé : audience prévue ou préférée pour cette image.
`audience.geographicArea`	AdministrativeArea	Recommandé : régions prévues ou préférées pour cette image. En revanche, utilisez `regionsAllowed` pour spécifier des restrictions strictes. Si `audience.geographicArea` n'est pas spécifié, il est supposé être destiné à être utilisé partout. Spécifiez les pays au format ISO 3166.
`copyrightHolder`	Organization ou Person	Recommandé : partie qui détient les droits d'auteur de l'image.
`keywords`	Texte	Recommandé : mots clés ou tags utilisés pour décrire cette image. Vous pouvez fournir plusieurs `keywords` à l'aide d'un tableau. (par exemple, ["feature, biography"]).
`name`	Texte	Recommandé : nom de l'image.
`width`	Entier	Facultatif : largeur de l'image en pixels, sous forme d'un entier positif (par exemple, `1920`). N'incluez pas de chaînes d'unités telles que `"px"`.
`height`	Entier	Facultatif : hauteur de l'image en pixels, sous forme d'un entier positif (par exemple, `1080`). N'incluez pas de chaînes d'unités telles que `"px"`.

contentAttributes

La propriété contentAttributes de image décrit le type de l'image et définit ses utilisations suggérées. Les catégories de la liste suivante incluent les valeurs contentAttributes que les fournisseurs doivent inclure dans chaque ImageObject.

Type

iconic : image illustrative qui représente l'émission. Il s'agit souvent d'un rendu artistique.
sceneStill : extrait d'image de l'émission.
castInCharacter : photo d'un membre de la distribution dans son rôle. Si vous utilisez cette valeur, incluez également la propriété character pour identifier le personnage spécifique dans l'image. S'il y a plusieurs personnages, comme dans une distribution, incluez plusieurs propriétés character sous forme de tableau.
logo : l'image ne contient qu'un logo. Il peut s'agir d'un logo graphique ou d'un logo de titre. Incluez l'overlay correspondant pour spécifier lequel.

Pour être valide, utilisez un seul de ces types.

Utilisation recommandée

poster : image d'affiche de l'émission. Dans les interfaces utilisateur d'ordinateur, elles peuvent être utilisées dans des carrousels. Elles peuvent contenir ou non le titre de la série.
background : image pouvant être utilisée comme arrière-plan avec des superpositions de texte ou d'interface utilisateur. Ces images ne contiennent pas de texte.

Pour que l'attribut soit valide, n'incluez pas plus d'une de ces utilisations recommandées.

Adéquation de la taille

smallFormat : image adaptée aux écrans plus petits, comme ceux des téléphones mobiles. Le texte ou les logos de l'image sont lisibles sur un petit écran.
largeFormat : image adaptée aux écrans plus grands ou aux affiches imprimées.

Remarque : En général, la plupart des images sont adaptées aux grands formats. Les exceptions sont les images basse résolution, qui sembleraient pixelisées si elles étaient agrandies.

Une image peut utiliser ces deux valeurs.

Adéquation de l'arrière-plan

forDarkBackground : image, généralement un logo transparent, pouvant être utilisée sur un arrière-plan sombre.
forLightBackground : image, généralement un logo transparent, adaptée à une utilisation sur un arrière-plan clair.

Pour être valide, utilisez au maximum une valeur d'adéquation de l'arrière-plan.

Superpositions

hasTitle : titre de l'émission, ou nom du personnage ou de l'acteur inclus dans l'image. Veillez à inclure la propriété inLanguage pour l'image.
noTitle : l'image n'inclut pas le titre.
hasLogo : l'image inclut le logo d'un film ou d'une émission, du propriétaire du contenu ou du distributeur.
noLogo : l'image n'inclut pas de logo.
hasCopyright : l'image inclut un avis de droits d'auteur visible.
noCopyright : l'image n'inclut pas d'avis de droits d'auteur visible. En général, Google ne peut pas utiliser ces images sans modification.
hasMatte : l'image comporte un cache. Il peut s'agir d'un format horizontal (letterbox), vertical (pillarbox) ou des deux (windowbox). Parfois, les images sont entourées d'un cadre pour s'adapter à un format. En règle générale, Google ne peut pas utiliser ces images sans modification.
noMatte : l'image n'a pas de cache.
transparentBackground : l'arrière-plan de l'image est transparent. Cette option est généralement utilisée pour les images qui ne contiennent qu'un titre ou un logo.

Pour être valide, un seul titre, un seul logo, un seul droit d'auteur et un seul attribut de cache sont autorisés.

Position de la figure prédominante

centered : la figure prédominante est positionnée au centre de l'image.
rightCentered : la figure prédominante est positionnée vers le côté droit de l'image, ce qui laisse le côté gauche relativement vide pour les superpositions de texte et d'interface utilisateur.
leftCentered : la figure prédominante est positionnée vers le côté gauche de l'image, ce qui laisse le côté droit relativement vide pour les superpositions de texte et d'interface utilisateur.

Pour être valide, incluez au maximum l'une de ces positions.

Exemples d'images avec leur utilisation prévue

Interface utilisateur TV affichant une image de fond avec du texte et une superposition d'interface utilisateur.

Interface utilisateur TV affichant des carrousels avec des images d'affiche sur une image de fond.

UI mobile avec une image d'affiche et une image de fond`iconic`.

UI mobile avec une image d'affiche et une image de fond`sceneStill`.

Exemples d'images et leurs contentAttributes

`contentAttributes: ["iconic", "poster", "centered", "hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"]`

`contentAttributes: ["iconic", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["iconic", "background", "rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]`

`contentAttributes: ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]`

`contentAttributes: ["castInCharacter", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character: {name: "Captain Pulsar"}`

`contentAttributes: ["logo", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "smallFormat", "largeFormat"]`

`contentAttributes: ["logo", "hasTitle", "hasLogo" "noCopyright", "noMatte", "centered", "transparentBackground", "forLightBackground", "forDarkBackground", "smallFormat", "largeFormat"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "noMatte"]`

`contentAttributes: ["iconic", "poster", "centered", "noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat", "largeFormat"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "hasMatte"]`

Types d'images souhaités pour les produits Google

Les différents produits et surfaces Google nécessitent des types d'images et des formats différents. Pour que le contenu s'affiche correctement sur tous les produits Google, nous demandons aux fournisseurs de fournir tous les types d'images du tableau suivant.

Format et contentAttributes	Résolution minimale (pixels)	Film	Séries télévisées	Saison télévisée	Épisode de série TV	Service de diffusion
16:9, `iconic` `poster`	3 840 x 2 160
2:3, `iconic` `poster`	1 000 x 1 500
4:3, `iconic` `poster`	800 x 600
1:1, `iconic` `poster`	600 x 600
3:4, `iconic` `poster`	600 x 800
16:9, `iconic` `background` [recommandé] ou `sceneStill`	3 840 x 2 160
2:3, `iconic` `background` [de préférence] ou `sceneStill`	1 000 x 1 500
3:4, `iconic` `background` [recommandé] ou `sceneStill`	600 x 800
1:1, Afficher le logo (`hasLogo`)	600 x 600
4:3, logo de la chaîne (`logo`)	800 x 600
1:1, logo de la chaîne (`logo`)	600 x 600
16:9, logo de la chaîne (`logo`)	3 840 x 2 160
9:5, `hasTitle` `logo` (avec `transparentBackground` et `forLightBackground` et `forDarkBackground`)	1 800 x 1 000

Les consignes suivantes s'appliquent lorsque vous envoyez des images :

Les images doivent être au format JPEG, PNG ou WebP.
Incluez les images avec la plus haute résolution dont vous disposez.
La taille des fichiers ne doit pas dépasser 20 Mo.
centered images sont préférables. Les images d'arrière-plan rightCentered et leftCentered peuvent également être utilisées par certains produits. Vous pouvez donc les inclure si vous en avez.
Nous préférons les images qui fonctionnent à la fois pour smallFormat et largeFormat.
Vous pouvez inclure des tailles d'image en plus de celles listées dans le tableau précédent.
Vérifiez que le format de chaque image correspond à l'une des valeurs courantes listées dans le tableau précédent. Sinon, un avertissement est émis.

Exemples d'images avec schéma

Les exemples suivants montrent comment mettre en forme le schéma des images associées à des films ou à des séries TV.

Image d'arrière-plan d'un film avec deux personnages

{
  "@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"]
      }
    ]
  }
}

Image de fond TVSeries limitée à deux régions

{
  "@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"]
      }
    ]
  }
}

Image d'affiche de film destinée à deux régions

{
  "@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"]
      }
    ]
  }
}

Affiche de film grand format en coréen et en anglais

{
  "@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"]
      }
    ]
  }
}

Représenter plusieurs images par région

{
  "@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"]
        }
      ]
    }]
}

Représenter des images limitées dans le temps

{
  "@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"]
        }
      ]
    }]
}