Propriétés de balisage de contenu des films

Cette section fournit les détails des 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 : toujours défini sur ["http://schema.org", {"@language": "xx"}]
  • Où ?" xx pouces représente la langue des chaînes du flux. Le paramètre @language de chaque contexte d'entité racine doit être défini 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 est l'anglais.
@type Texte Obligatoire : toujours défini sur Movie pour les films.
@id URL Obligatoire : identifiant du contenu au format URI (par exemple, https://example.com/1234abc).
@id doit remplir les conditions suivantes:
  • Unique au niveau mondial dans votre catalogue
  • Statique ; L'ID doit être stable et immuable dans le temps (même si la propriété d'URL de l'émission change). Elle sera traitée comme une chaîne opaque et ne doit pas nécessairement être un lien fonctionnel.
  • Sous la forme d'un identifiant de ressource unifié (URI)
  • 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 l'attribut url d'une entité en tant que @id. Pour en savoir plus, consultez la section Identifiant.
url URL Obligatoire : l'URL canonique du contenu, que Google utilise pour établir une correspondance entre le contenu de votre flux et celui de ses bases de données.
url doit respecter les exigences 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 répertorier les noms dans différentes langues. Consultez l'exemple Plusieurs régions et langues.
  • Notez qu'un seul nom est accepté par langue (combinaison langue-pays).
titleEIDR Texte Fortement recommandé Pourquoi ? : identifiant EIDR (Entertainment Identifier Registry) représentant au niveau le plus général/abstrait d'une œuvre de film ou de télévision.

Exemple : titre EIDR pour le film "SOS Fantômes" est "10.5240/7EC7-228A-510A-053E-CBB8-J".
editEIDR Texte Fortement recommandé Pourquoi ? - Un identifiant EIDR (Entertainment Identifier Registry) représentant le montage / l'édition d'une œuvre d'un film ou d'une émission télévisée.

Exemple : le film "SOS Fantômes" dont le titre EIDR est "10.5240/7EC7-228A-510A-053E-CBB8-J", a plusieurs modifications, 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 le montage EIDR est fourni.
potentialAction WatchAction Obligatoire, le cas échéant : un objet de balisage Action qui fournit les détails de l'action.
  • Si le contenu est disponible pour la vidéo à la demande (VoD), cette propriété est obligatoire. L'objet de balisage Action doit fournir le lien profond du contenu.
  • Si le contenu est disponible sur une chaîne LiveTV, cette propriété est facultative. À la place, l'entité BroadcastService associée fournit le lien profond du canal.
  • Un Movie peut être disponible à la fois sur VoD et LiveTV.
Utilisez un tableau pour spécifier différents liens profonds dans plusieurs régions. Consultez l'exemple Plusieurs régions et langues.
sameAs URL Fortement recommandé Pourquoi ? URL d'une page Web de référence pouvant identifier le film. par exemple, la page Wikipédia du film. Elle doit être distincte de la propriété url.
inLanguage Texte Langue d'origine du film au format BCP 47.
genre Texte Liste numérotée de tous les genres pertinents. Exemples : ["Action", "Mode", "Environnement", "Football"]
keywords Texte Mots clés ou tags utilisés pour décrire ce contenu. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés permettant de décrire le contenu.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Fortement recommandé Pourquoi ? - Un PublicationEvent permet d'indiquer la sortie originale (mondiale ou locale) d'un contenu par un éditeur, comme sa date de sortie en salle.

Vous pouvez également utiliser FeaturedEvent pour indiquer que votre service commercialise ce contenu en tant que contenu original, sélectionné, spécial, etc.

ExclusiveEvent indique que votre service dispose de droits de distribution exclusifs, et indique où et quand.

Consultez la section Exemples pour obtenir des détails et des exemples.
releasedEvent.@type Texte Obligatoire : assurez-vous de toujours définir cette propriété sur l'une des valeurs suivantes :
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Pays Obligatoire : régions associées à cet événement.

Pour une PublicationEvent, il s'agit de la région dans laquelle le contenu a été publié.

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

Utilisez les codes ISO 3166 pour les pays. Pour indiquer partout dans le monde, 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 PublicationEvent, il s'agit de la date de sortie initiale de cette entité, par exemple la date de la première sortie du film en salle.

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

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

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

Si le contenu est exclusif ou mis en avant en permanence, définissez endDate sur 20 ans à compter de la date du jour.
releasedEvent.publishedBy Organisation ou personne Facultatif. Organisation ou personne ayant publié cette entité.
description Texte Fortement recommandé Pourquoi ? Synopsis du film. Les résumés de l'intrigue sont préférables aux résumés factuels. 300 caractères maximum.
duration Durée Exécution de la vidéo au format ISO 8601. Veuillez utiliser le format suivant : "PT00H00M".
director Personne Fortement recommandé Pourquoi ? Réalisateur(s) du film.
actor Personne Fortement recommandé Pourquoi ? Le ou les acteurs du film.
producer Organisation ou personne 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 Propriétés de l'image.
trailer.description Texte Description de la bande-annonce. Consultez l'exemple de 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 respectifs ou des sources autorisées.
trailer.regionsAllowed Place Régions dans lesquelles le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
identifier PropertyValue Fortement recommandé Pourquoi ? - Identifiant externe ou autre identifiant qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés de l'identifiant.
review Avis Voir les notes pour le film
review.reviewRating Note Obligatoire si un examen est effectué. Cet attribut permet de spécifier la note attribuée à l'avis.
contentRating Text ou Rating Obligatoire pour le contenu réservé aux adultes, fortement recommandé dans les autres cas 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 a été ajoutée avant la note par un espace blanc. Par exemple, un "PG-13" note de l'agence "MPAA" aux États-Unis est dénommée "MPAA PG-13". Consultez la liste des agences.
  • La valeur "RATING NOT KNOWN" (non sensible à la casse) pour indiquer que vous ne connaissez pas la classification du film.
contentRating.author Entreprise Obligatoire si contentRating utilise Rating : nom de l'agence de classification.
contentRating.ratingValue Texte Obligatoire si contentRating utilise Rating : valeur de la note.
contentRating.advisoryCode Texte Code de recommandation du contenu. Les valeurs acceptées incluent D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.
popularityScore PopularityScoreSpecification Fortement recommandé Pourquoi ? Score utilisé par Google, ainsi que d'autres signaux, pour déterminer quels contenus multimédias proposer aux utilisateurs. Cette note indique la popularité du contenu par rapport aux autres contenus de votre catalogue. Par conséquent, l'échelle du score doit être cohérente entre vos flux et toutes les entités de votre catalogue. Par défaut, le niveau 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 indiquant la popularité de l'entité. un score élevé signifie une popularité plus élevée.
popularityScore.eligibleRegion Pays Région(s) dans laquelle ce score de popularité est applicable. Si l'indice de popularité s'applique au niveau mondial, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH.
Note: La popularité spécifique aux paramètres régionaux a priorité sur la popularité globale (EARTH).
category Texte Obligatoire, le cas échéant : 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 un visionnage à domicile.
  • Theatrical Release: version sortie en salle
  • International Release: version modifiée pour être publiée dans le monde entier.
  • Remastered: version dont les images, le son ou les deux ont été améliorés selon une norme plus récente.
  • Unrated: version qui n'a pas été examinée par la MPAA ou une agence similaire.
  • Director Cut: version représentant la modification approuvée par le réalisateur.
  • Extended Cut: version plus longue que la sortie en salle.
workExample Film Spécifie les variantes du film. Incluez cette propriété dans l'entité Movie principale, et non dans les entités Movie pour les versions de variante.
workExample.@id URL Pour les variantes Movie, cette propriété fournit le @id de l'entité Movie dont il s'agit.
workExample.@type Texte Obligatoire : toujours défini sur Movie. Il peut être représenté sous la forme d'un tableau pour un élément 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 particulière. Définissez la catégorie sur l'une des valeurs suivantes:
  • Home Release: version vendue ou louée pour un visionnage à domicile.
  • Theatrical Release: version sortie en salle
  • International Release: version modifiée pour être publiée dans le monde entier.
  • Remastered: version dont les images, le son ou les deux ont été améliorés selon une norme plus récente.
  • Unrated: version qui n'a pas été examinée par la MPAA ou une agence similaire.
  • Director Cut: version représentant la modification approuvée par le réalisateur.
  • Extended Cut: version plus longue que la sortie en salle.

Exemple

Film principal

Film avec une variante de coupe é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 de coupe étendue

Version longue 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"
}

Consultez les pages suivantes pour en savoir plus sur les sujets liés à ces propriétés: