Propriétés d'image

Cette section détaille les propriétés de balisage de contenu de image pour les films et les séries TV. des séries TV. Ce balisage permet aux fournisseurs de décrire le type d'image, par exemple, si il s'agit d'un titre, d'un arrière-plan ou d'une image emblématique, ainsi que son utilisation suggérée.

Tableau des spécifications

La propriété image peut être fournie pour Movie, TVSeries TVSeason ou TVEpisode types d'entités. Le tableau suivant décrit les propriétés disponibles pour image. Notez que la propriété additionalProperty inclut un nom de la propriété personnalisée appelé contentAttributes, qui contient un tableau de valeurs qui décrivent 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, lire contentAttributes
character Personne

Obligatoire, le cas échéant : Un personnage fictif associé à l'image. Obligatoire si contentAttribute inclut castInCharacter.

inLanguage Texte Obligatoire, le cas échéant : langue du texte utilisé dans la l'image. Utilisez l'un des codes de langue 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 ce n'est pas le cas spécifié, il est supposé que l'image est autorisée partout. Spécifiez les pays de Format ISO 3166.
datePublished Date

Obligatoire, le cas échéant : date à partir de laquelle l'image est disponible, au format ISO Format 8601 (fuseau horaire compris).

  • 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 spécifiée. Si aucune existe, il peut être omis. L'image correspondante doit obligatoirement être fournies dans le flux au moins sept jours avant leur date de publication. Cela permettra améliorer les chances que votre contenu s'affiche à temps sur les surfaces Google.

expires Date

Obligatoire, le cas échéant : date à partir de laquelle l'image ne sera plus disponible. en ISO Format 8601 (fuseau horaire compris).

  • Si le contenu est toujours disponible après sa publication, vous pouvez omettre cette .

Toute mise à jour 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 apparaître sur les surfaces Google à la date d'expiration.

audience Audience Recommandé : audience cible ou préférée pour cet élément. l'image.
audience.geographicArea AdministrativeArea Recommandé : régions souhaitées ou préférées pour cette image. En revanche, utilisez regionsAllowed pour spécifier de restrictions. Si audience.geographicArea n'est pas spécifié, alors il est supposé être destiné à être utilisé partout. Spécifiez le paramètre pays en Format ISO 3166.
copyrightHolder Organisation ou Personne Recommandé – La partie titulaire des 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 fournies à 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 les utilisations suggérées. Les catégories de la liste suivante sont les suivantes : Valeurs contentAttributes que les fournisseurs doivent inclure dans chaque ImageObject.

Type

  • iconic: image qui illustre l'émission. Souvent artistique, le rendu.
  • sceneStill: extrait d'une image de l'émission.
  • castInCharacter: photo d'un membre de la distribution tel qu'il apparaît dans son personnage. Si utilisez cette valeur, incluez également le character pour identifier le caractère spécifique de la propriété l'image. S'il y a 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 un logo de titre. Incluez la superposition correspondante pour spécifier laquelle.

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

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

Pour être valide, vous devez inclure au maximum l'une des utilisations recommandées.

Convient aux tailles

  • smallFormat: image adaptée aux petits écrans (comme les mobiles) téléphones. 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.

Éligibilité de l'arrière-plan

  • forDarkBackground: image adaptée (généralement un logo transparent) pour une utilisation sur un fond sombre.
  • forLightBackground: image adaptée (généralement un logo transparent) pour une utilisation sur un fond clair.

Pour être valide, utilisez au maximum une valeur d'adéquation d'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 série, le propriétaire du contenu ou le distributeur.
  • noLogo: l'image ne comporte 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. Google ne peuvent généralement pas utiliser de telles images sans modification.
  • hasMatte: l'image a un aspect mat. Il peut s'agir d'un format horizontal (format letterbox), vertical (pillarbox) ou les deux (windowbox). Parfois, les images sont mal ajustées pour s'adapter dans un format. En règle générale, Google ne peut pas utiliser de telles images sans modification.
  • noMatte: l'image n'a pas de surface mate.
  • transparentBackground: l'arrière-plan de l'image est transparent. C'est généralement utilisé pour les images qui ne sont qu'un titre ou un logo et rien d'autre.

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

Position de la figure dominante

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

Pour être valide, vous devez inclure au maximum une de ces positions.

Exemples d'images et leur utilisation prévue

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

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 différents types d'images et formats. Pour s'assurer que le contenu s'affiche correctement dans tous les produits Google, nous demandons aux fournisseurs de fournir des types d'images indiqués dans le 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, poster iconic 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 les deux 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 dont la résolution est la plus élevée.
  3. La taille des fichiers ne doit pas dépasser 20 Mo.
  4. Utilisez de préférence des images centered. 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 qui fonctionnent à la fois pour smallFormat et largeFormat.
  6. Vous pouvez inclure des tailles d'image en plus de celles indiquées tableau.
  7. Vérifiez que le format de chaque image correspond à l'une des valeurs courantes répertoriées dans 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 pour les images associées à des films ou des séries TV.

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

Affiche 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"]
      }
    ]
  }
}

Grande affiche de film avec du coréen et de l'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"]
        }
      ]
    }]
}