Propriétés de l'image

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette section détaille les propriétés de balisage de contenu de image pour les films et les séries TV. Ce balisage permet aux fournisseurs de décrire le type d'image, par exemple s'il s'agit d'un titre, d'une image de fond ou d'une image emblématique, et la suggestion d'utilisation.

Tableau de spécifications

La propriété image peut être fournie pour les types d'entités Movie, TVSeries, TVSeason ou TVEpisode. 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é 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 si applicable : caractère fictif associé à l'image. Cette valeur est obligatoire si contentAttribute inclut castInCharacter.
inLanguage Texte Obligatoire si applicable : 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 Établissement Recommandé : régions où l'image est autorisée. Si aucune valeur n'est spécifiée, nous supposons que l'image est autorisée partout. Spécifiez les pays au format ISO 3166.
datePublished Date

Obligatoire si applicable : date après laquelle l'image est disponible, au format ISO 8601 (fuseau horaire compris).

  • La date peut être définie dans le futur.

Si des restrictions temporelles s'appliquent à l'utilisation de l'image, cette propriété est obligatoire si l'image ne doit pas être affichée avant la date donnée. S'il n'existe aucune restriction de ce type, vous pouvez l'omettre. L'image correspondante doit être fournie dans le flux au moins sept jours avant sa date de publication. Vous augmenterez ainsi les chances que le contenu s'affiche sur les plates-formes Google à temps.

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é.

Toutes les mises à jour de la date d'expiration doivent être apportées au flux au moins sept jours avant la date d'expiration. Vous aurez ainsi plus de chances que le contenu cesse d'apparaître sur les surfaces Google à la date d'expiration.

audience Audience Recommandé : audience souhaitée ou privilégiée pour cette image.
audience.geographicArea Région administrative Recommandé : régions souhaitées ou souhaité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 utilisé partout. Spécifiez les pays au format ISO 3166.
copyrightHolder Organisation ou personne Recommandé : partie qui détient les droits d'auteur sur l'image.
keywords Texte Recommandé : mots clés ou tags utilisés pour décrire cette image. Les entrées d'une liste keywords doivent être séparées par une virgule.
name Texte Recommandé : nom de l'image.

Attributs de contenu

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

Type

  • iconic: illustrateur illustrant l'émission. Il s'agit souvent d'un rendu artistique.
  • sceneStill: extrait de l'émission.
  • castInCharacter : photo d'un membre de la distribution telle qu'elle apparaît en personnage. Si vous utilisez cette valeur, incluez également la propriété character pour identifier le caractère spécifique de l'image. S'il existe plusieurs caractères, comme dans un ensemble de cast, 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 la superposition correspondante pour spécifier laquelle.

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

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

Pour être valide, indiquez au maximum l'une de ces utilisations recommandées.

Taille adaptée

  • smallFormat : image adaptée aux petits écrans, comme les téléphones mobiles. Le texte ou les logos de l'image sont lisibles sur un petit écran.

  • largeFormat: image adaptée aux grands écrans ou aux affiches imprimées.

Une image peut utiliser ces deux valeurs.

Contexte adapté

  • forDarkBackground : image, généralement un logo transparent, adaptée à un arrière-plan sombre.
  • forLightBackground: image, généralement un logo transparent, adaptée à un arrière-plan clair.

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

Messages en superposition

  • hasTitle : titre de l'émission, ou nom du personnage ou de l'acteur inclus dans l'image. Veillez à inclure la propriété inLanguage de l'image.
  • noTitle: l'image n'inclut pas le titre.
  • hasLogo : l'image inclut le logo d'un film ou d'une série, le propriétaire du contenu ou le 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 règle générale, Google ne peut pas utiliser de telles images sans les modifier.
  • hasMatte : l'image est mate. Il peut s'agir d'une annonce horizontale (letterbox), verticale (pillarbox) ou des deux (windowbox). Parfois, les images sont mates pour s'adapter à un format donné. En règle générale, Google ne peut pas utiliser de telles images sans les modifier.
  • noMatte : l'image n'a pas de aspect mat.
  • transparentBackground: l'arrière-plan de l'image est transparent. Il est généralement utilisé pour les images qui ne constituent qu'un titre ou logo, et rien d'autre.

Pour être valides, un seul titre, un seul logo, un seul droit d'auteur et un seul attribut mat sont autorisés.

Position du personnage prédominant

  • 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 sur 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, ajoutez au moins une de ces positions.

Exemples d'images à l'usage prévu

Interface utilisateur d'un téléviseur qui affiche une image d'arrière-plan avec du texte et une superposition d'interface utilisateur
Interface utilisateur d'une télévision qui affiche des carrousels avec des images poster sur une image de fond.
Interface utilisateur mobile avec une image poster et une image iconic en arrière-plan.
Interface utilisateur mobile avec une image poster et une image sceneStill en arrière-plan.

Exemples d'images et leurs attributs contentAttribute

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 types d'images et les proportions diffèrent d'un produit et d'une surface à l'autre. Pour nous assurer que le contenu s'affiche correctement dans 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érie TV Saison de série TV Épisode de série TV Service de diffusion
16:9, 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, iconic poster

 600x800

16:9, iconic background [de préférence] ou sceneStill

 3 840 x 2 160

2:3, iconic background (de préférence) ou sceneStill

 1000x1500

3:4, iconic background (de préférence) ou sceneStill

 600x800
1:1, afficher le logo (hasLogo) 600x600
4:3, logo de la chaîne (logo) 800 x 600
1:1, logo de la chaîne (logo) 600x600
16:9, logo de la chaîne (logo) 3 840 x 2 160

9:5, hasTitle logo (avec transparentBackground, et forLightBackground et forDarkBackground)

 1800x1000

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

  1. Les images doivent être au format JPEG, PNG ou WebP.
  2. Incluez les images en haute résolution.
  3. La taille des fichiers ne doit pas dépasser 20 Mo.
  4. Privilégiez centered images. Les images de fond rightCentered et leftCentered peuvent également être utilisées par certains produits. Vous pouvez donc les inclure si vous en avez.
  5. Nous préférons les images compatibles à la fois avec smallFormat et largeFormat.
  6. Vous pouvez inclure des tailles d'image en plus de celles répertoriées dans le tableau précédent.
  7. Vérifiez que le format de chaque image correspond à l'une des valeurs courantes répertoriées dans le tableau précédent. Sinon, un avertissement est envoyé.

Exemples d'images avec schéma

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

Image de fond du film avec deux caractères

{
  "@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 poster 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 en grand format, à la fois coréen et 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"]
        }
      ]
    }]
}