Propriétés de l'image

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'un arrière-plan ou d'une image emblématique) et de son utilisation suggérée.

Table des 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 : cette valeur est toujours définie sur "http://schema.org".
@type Texte Obligatoire : cette valeur est toujours définie 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 : caractère fictif associé à l'image. Cet élément est obligatoire si contentAttribute inclut castInCharacter.
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 hasTitle, cette propriété est obligatoire.
regionsAllowed Établissement Recommandé : régions où l'image est autorisée. Sinon, nous partons du principe que l'image est 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 compris).

  • Cette date peut être ultérieure à la date du jour.

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 donnée. S'il n'existe aucune restriction de ce type, elle peut être omise. 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 à 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é.

Les flux doivent être mis à jour dans le flux au moins sept jours avant la date d'expiration. Vous augmenterez ainsi les 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 prévues ou préférées pour cette image. En revanche, utilisez regionsAllowed pour spécifier les restrictions strictes. Si audience.geographicArea n'est pas spécifié, il est censé être utilisé partout. Spécifiez les pays au format ISO 3166.
copyrightHolder Organisation ou personne Recommandé : Partie détenant les droits d'auteur sur l'image.
keywords Texte Recommandé : mots clés ou tags utilisés pour décrire cette image. Plusieurs keywords peuvent être fournis à l'aide d'un tableau. Par exemple, ["fonctionnalité, biographie"]
name Texte Recommandé : Nom de l'image.

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 avec chaque ImageObject.

Type

  • iconic: image d'illustration de l'émission. Il s'agit souvent d'un rendu artistique.
  • sceneStill: extrait de l'émission.
  • castInCharacter: photo d'un membre de la distribution tel qu'il apparaît. 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 du podcast. Dans l'interface utilisateur informatique, elles peuvent être utilisées dans des carrousels. Il peut s'agir du titre de l'émission ou non.
  • background: image pouvant être utilisée comme arrière-plan avec du texte ou des superpositions d'interface utilisateur. Ces images ne contiennent pas de texte.

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

Taille adaptée

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

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

Une image peut utiliser ces deux valeurs.

Arrière-plan approprié

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

Superpositions

  • hasTitle: titre de la série, 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, d'une série, du propriétaire du contenu ou du distributeur.
  • noLogo: l'image n'inclut pas de logo.
  • hasCopyright: l'image inclut un avis visible sur les droits d'auteur.
  • noCopyright: l'image n'inclut pas d'avis de droits d'auteur visible. En général, Google ne peut pas utiliser de telles images sans les modifier.
  • hasMatte: l'image est mate. Il peut s'agir d'un cadre horizontal (letterbox), vertical (pillarbox) ou des deux (boxboxer). Parfois, les images sont mates pour s'adapter à un format. Google ne peut généralement pas utiliser de telles images sans les modifier.
  • noMatte: l'image n'a pas de mat.
  • transparentBackground: l'arrière-plan de l'image est transparent. Elle est généralement utilisée pour les images qui ne sont qu'un titre ou un logo.

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

Position de la prédominance

  • centered: la figure prédominante est positionnée au centre de l'image.
  • rightCentered: la figure prédominante est positionnée sur la droite de l'image, ce qui laisse le côté gauche 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, incluez au maximum l'une de ces positions.

Exemples d'images correctement utilisées

UI de télévision qui affiche une image de fond avec du texte et une superposition d'UI.
Interface utilisateur de 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 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

Différents produits et surfaces Google nécessitent des types d'image et des formats différents. Pour nous assurer que le contenu s'affiche correctement sur tous les produits Google, nous demandons aux fournisseurs de fournir tous les types d'images dans le 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 [preferred] ou sceneStill

 3 840 x 2 160

2:3, iconic background [recommandé] ou sceneStill

 1000x1500

3:4, iconic background [preferred] 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)

 1 800 x 1 000

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. De préférence des images centered. Les images de fond rightCentered et leftCentered peuvent également être utilisées par certains produits. Vous pouvez donc les inclure, le cas échéant.
  5. Nous privilégions les images compatibles à la fois avec smallFormat et largeFormat.
  6. Vous pouvez inclure des tailles d'image en plus de celles listées dans le tableau précédent.
  7. Vérifiez que le format de chaque image correspond à l'une des valeurs communes répertoriées dans le tableau précédent. Sinon, un avertissement s'affiche.

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 de fond du 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 poster du 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 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"]
        }
      ]
    }]
}