Propriétés de balisage de contenu des films

Cette section fournit des informations sur les propriétés de balisage de contenu pour le type d'entité Movie.

Tableau des spécifications

Propriété Type attendu Description
@context Texte Obligatoire : doit toujours être défini sur ["http://schema.org", {"@language": "xx"}]
  • "xx" représente la langue des chaînes du flux. La valeur @language de chaque contexte d'entité racine doit être définie sur le code de langue approprié au format BCP 47. Par exemple, si la langue est définie sur l'espagnol, les noms sont supposés être en espagnol, même si la langue des sous-titres/du doublage est l'anglais.
@type Texte Obligatoire : doit toujours être défini sur Movie pour les films.
@id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
@id doit respecter les conditions suivantes :
  • Unique dans l'ensemble de votre catalogue
  • Statique : l'ID doit être stable et ne pas changer au fil du temps (même si la propriété d'URL de l'émission change). Il sera traité comme une chaîne opaque et ne doit pas nécessairement s'agir d'un lien fonctionnel.
  • Au format URI (Uniform Resource Identifier)
  • Le domaine utilisé pour la valeur @id doit appartenir à votre organisation.
Étant donné que le url d'une entité répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser le url d'une entité comme @id. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire : URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux à celui des bases de données de Google.
url doit respecter les conditions suivantes :
  • url doit être unique
  • url doit contenir une URL canonique fonctionnelle que Google peut explorer.
Pour le lien profond de la lecture, consultez plutôt la propriété urlTemplate de l'objet cible.
name Texte Obligatoire : nom du film.
  • Utilisez un tableau pour lister les noms dans différentes langues. Consultez l'exemple Plusieurs pays et langues.
  • Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
titleEIDR Texte Fortement recommandé Pourquoi ? - Un identifiant EIDR (Entertainment Identifier Registry) représentant, au niveau le plus général/abstrait, une œuvre cinématographique ou télévisuelle.

Par exemple, le titreEIDR du film "Ghostbusters" est "10.5240/7EC7-228A-510A-053E-CBB8-J".
editEIDR Texte Fortement recommandé Pourquoi ? - Un identifiant EIDR (Entertainment Identifier Registry) représentant un montage spécifique d'une œuvre cinématographique ou télévisuelle.

Par exemple, le film "Ghostbusters", dont le titre EIDR est "10.5240/7EC7-228A-510A-053E-CBB8-J", comporte plusieurs montages, par exemple "10.5240/1F2A-E1C5-680A-14C6-E76B-I" et "10.5240/8A35-3BEE-6497-5D12-9E4F-3". La propriété

titleEIDR est obligatoire lorsque l'attribut editEIDR est fourni.
potentialAction WatchAction Obligatoire si applicable : objet de balisage d'action qui fournit les détails de l'action.
  • Si le contenu est disponible en vidéo à la demande (VOD), cette propriété est obligatoire. L'objet de balisage d'action doit fournir le lien profond du contenu.
  • Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. L'entité BroadcastService associée fournit plutôt le lien profond de la chaîne.
  • Un Movie peut être disponible à la fois sur la VOD et la TV en direct.
Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs pays et langues.
sameAs URL Fortement recommandé Pourquoi ? URL d'une page Web de référence permettant d'identifier le film (par exemple, la page Wikipédia du film). Il doit être distinct de la propriété url.
inLanguage Texte Langue d'origine du film au format BCP 47.
genre Texte Liste triée de tous les genres pertinents. Exemple : ["Action", "Mode", "Environnement", "Football"]
keywords Texte Mots clés ou balises utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["feature, biography"] peut être un tableau de mots clés pour décrire le contenu.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Fortement recommandé Pourquoi ? - PublicationEvent permet de spécifier la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme la date de sortie initiale d'un film.

En outre, utilisez FeaturedEvent pour indiquer que votre service commercialise ce contenu en tant que contenu original, mis en avant, spécial, etc.

ExclusiveEvent indique que votre service dispose de droits de distribution exclusifs et inclut l'endroit et la date.

Pour en savoir plus et obtenir des exemples, consultez la section d'exemples.
releasedEvent.@type Texte Obligatoire : veillez à toujours définir cette propriété sur l'un des éléments suivants :
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Pays Obligatoire : régions associées à cet événement.

Pour un PublicationEvent, il s'agit de la région où le contenu a été publié.

Pour FeaturedEvent et ExclusiveEvent, il s'agit de la région où le contenu est mis en avant ou exclusif.

Utilisez des codes ISO 3166 pour les pays. Pour indiquer le monde entier, définissez la valeur sur EARTH.
releasedEvent.startDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : date de début de la publication de l'entité.

Pour un PublicationEvent, il s'agit de la date de sortie initiale de l'entité, par exemple la date de sortie d'un film en salles.

Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date de début de la période pendant laquelle l'entité est exclusive ou mise en avant.
releasedEvent.endDate Date ou DateTime Recommandé : Obligatoire pour ExclusiveEvent : ne s'applique qu'aux types ExclusiveEvent et FeaturedEvent.

Pour ExclusiveEvent, il s'agit de la date d'expiration des droits sur le contenu.

Pour FeaturedEvent, il s'agit de la dernière date à laquelle le fournisseur a présenté l'entité.

Si le contenu est toujours exclusif ou présenté, définissez endDate sur 20 ans à compter de la date actuelle.
releasedEvent.publishedBy Organization ou Person Facultatif : organisation ou personne ayant publié cette entité.
description Texte Fortement recommandé Pourquoi ? Synopsis du film. Les synopsis de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum.
duration Durée Durée du film au format ISO 8601. Veuillez utiliser le format "PT00H00M".
director Personne Fortement recommandé Pourquoi ? Réalisateur(s) du film.
actor Personne Fortement recommandé Pourquoi ? Acteur ou actrice du film.
producer Organization ou Person Fortement recommandé Pourquoi ? Producteur(s) du film.
image ImageObject Obligatoire pour Google TV : images associées au film. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec image, consultez la section Propriétés des images.
trailer.description Texte Description de la bande-annonce. Consultez l'exemple Bande-annonce.
trailer.inLanguage Texte Langue de la bande-annonce au format BCP 47.
trailer.url URL URL d'une bande-annonce hébergée publiquement et mise en ligne par les studios de production ou les sources autorisées respectifs.
trailer.regionsAllowed Place Régions dans lesquelles le contenu multimédia est autorisé. Si cet attribut n'est pas spécifié, il est considéré comme autorisé partout. Spécifiez les pays au format ISO 3166.
identifier PropertyValue Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie clairement cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés d'identifiant.
review Avis Avis sur le film
review.reviewRating Note Obligatoire si une évaluation est fournie. Permet de spécifier la note attribuée dans l'avis.
contentRating Text ou Rating Obligatoire pour les contenus réservés aux adultes, fortement recommandé dans le cas contraire Pourquoi ? - Classification globale du contenu Si la classification du contenu est indiquée sous la forme d'une chaîne de texte, deux variantes sont acceptées:
  • L'agence de notation est placée avant la note, avec un espace en-tre. Par exemple, une classification "PG-13" attribuée par l'organisme "MPAA" aux États-Unis doit être décrite comme "MPAA PG-13". Consultez la liste des agences.
  • La valeur "RATING NOT KNOWN" (insensible à la casse) pour indiquer que vous ne connaissez pas la classification du film.
contentRating.author Entreprise Obligatoire si contentRating utilise Rating : nom de l'organisme de classification.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la classification.
contentRating.advisoryCode Texte Code d'avertissement du contenu. Les valeurs acceptées sont : D, FV, L, S et V. D = Dialogue, FV = Violence fantastique, L = Langue, S = Contenu sexuel, V = Violence.
popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score que Google utilise, ainsi que d'autres signaux, pour déterminer les contenus multimédias à diffuser auprès des utilisateurs. Ce score représente la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente dans vos flux, pour toutes les entités de votre catalogue. Par défaut, le score de popularité d'une entité est défini sur 0.
popularityScore.@type Texte Toujours défini sur PopularityScoreSpecification.
popularityScore.value Number Valeur numérique non négative qui indique la popularité de l'entité. Plus le score est élevé, plus l'entité est populaire.
popularityScore.eligibleRegion Pays Région(s) où ce score de popularité s'applique. Si le score de popularité est applicable à l'échelle mondiale, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité spécifique à une zone géographique prévaut sur la popularité globale (EARTH)
category Texte Obligatoire si applicable : renseignez cette propriété si l'entité est une variante Movie. Définissez category sur l'une des valeurs suivantes:
  • Home Release: version vendue ou louée pour être visionnée à domicile.
  • Theatrical Release: version diffusée dans les salles de cinéma.
  • International Release: version modifiée pour être diffusée à l'international.
  • Remastered: version dont les images, le son ou les deux sont améliorés selon des normes plus récentes.
  • Unrated: version non visionnée par la MPAA ou une agence similaire.
  • Director Cut: version représentant le montage approuvé par le réalisateur.
  • Extended Cut: version plus longue que la version cinématographique.
workExample Film Spécifie les variantes du film. Incluez cette propriété dans l'entité Movie principale, et non dans les entités Movie des versions de variantes.
workExample.@id URL Pour les variantes Movie, cette propriété fournit le @id de l'entité Movie dont il s'agit d'une variante.
workExample.@type Texte Obligatoire : doit toujours être défini sur Movie. Cela peut être représenté sous forme de tableau pour un Movie avec plusieurs variantes.
workExample.@id URL Obligatoire : @id de la variante Movie.
workExample.name Texte Obligatoire : nom de la variante Movie.
workExample.category Texte Obligatoire : type de variante de film d'une version spécifique. Définissez la catégorie sur l'une des valeurs suivantes:
  • Home Release: version vendue ou louée pour être visionnée à domicile.
  • Theatrical Release: version diffusée dans les salles de cinéma.
  • International Release: version modifiée pour être diffusée à l'international.
  • Remastered: version dont les images, le son ou les deux sont améliorés selon des normes plus récentes.
  • Unrated: version non visionnée par la MPAA ou une agence similaire.
  • Director Cut: version représentant le montage approuvé par le réalisateur.
  • Extended Cut: version plus longue que la version cinématographique.

Exemple

Film principal

Film avec une version étendue.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie",
  "url": "http://www.example.com/my_favorite_movie",
  "name": "My Favorite Movie",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
  "contentRating": "RATING NOT KNOWN",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 78,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
  "workExample": {
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie_extended_cut",
      "name": "My Favorite Movie Extended Cut"
      "category": "Extended Cut"
  }
}

Variante "version longue"

Version étendue du film principal.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "Movie",
  "@id": "http://www.example.com/my_favorite_movie_extended_cut",
  "url": "http://www.example.com/my_favorite_movie_extended_cut",
  "name": "My Favorite Movie Extended Cut",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package",
        "identifier": "example.com:example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        },
        {
          "@type": "Country",
          "name": "CA"
        }
      ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
  "contentRating": {
        "@type": "Rating",
        "author": "MPAA",
        "ratingValue": "R",
        "advisoryCode": "FV"
   },
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "This is the extended cut of my favorite movie.",
  "actor": [
    {
      "@type": "Person",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
    },
    {
      "@type": "Person",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
    }
  ],
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "IMDB_ID",
      "value":  "tt0123456"
    }
  ],
 "exampleOfWork": {
  "@id": "http://www.example.com/my_favorite_movie",
 }
 "category": "Extended Cut"
}

Pour en savoir plus sur ces propriétés, consultez les pages suivantes: