Cette page a été traduite par l'API Cloud Translation.

Propriétés de balisage de contenu des films

Cette section décrit en détail les propriétés de balisage du contenu pour le type d'entité Movie.

Table des spécifications

Propriété	Type attendu	Description
`@context`	Texte	Obligatoire : toujours défini sur `["http://schema.org", {"@language": "xx"}]` où xx" représente la langue des chaînes du flux. Le contexte de chaque entité racine doit être défini sur le code de langue approprié, au format BCP 47. Par exemple, si la langue est l'espagnol, les noms sont considérés comme étant en espagnol, même si la langue du sous-titre est en anglais.
`@type`	Texte	Obligatoire : toujours défini sur `Movie` pour les films.
`@id`	URL	Obligatoire : l'identifiant du contenu au format URI (par exemple, https://example.com/1234abc). `@id` doit répondre aux exigences suivantes : Unique au niveau mondial dans votre catalogue Statique. L'ID doit être stable et ne pas changer au fil du temps (même si la propriété de l'URL de l'émission change). Elle est 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é qu'une entité `url` répond à toutes les exigences en tant qu'identifiant, nous vous recommandons d'utiliser une `url` d'entité comme `@id`. Consultez la section Identifiant pour en savoir plus.
`url`	URL	Obligatoire : l'URL canonique du contenu, que Google utilise pour faire correspondre le contenu de votre flux avec le contenu des bases de données de Google. `url` doit répondre aux exigences suivantes : `url` doit être unique au niveau mondial `url` doit contenir une URL canonique fonctionnelle que Google peut explorer. Pour les liens profonds de 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 régions et langues. Notez qu'un seul nom est accepté par paramètre régional (paire langue-pays).
`titleEIDR`	Texte	Fortement recommandé Pourquoi ? - Identifiant EIDR (Entertainment Identifier Registry) représentant au niveau général/abstrait une œuvre de cinéma ou de télévision. Par exemple, le titre "EIDR" pour une image animée appelée "Ghostbusters" est "10.5240/7EC7-228A-510A-053E-CBB8-J"".
`editEIDR`	Texte	Fortement recommandé Pourquoi ? - Identifiant EIDR (Entertainment Identifier Registry) représentant une modification / édition spécifique pour une œuvre de cinéma ou de télévision. également connu sous le nom de service `titleEIDR` La propriété est obligatoire lorsque l'élément EIDR est fourni.
`potentialAction`	WatchAction	Obligatoire, le cas échéant : objet de balisage d'action qui fournit les détails de l'action. Si le contenu est disponible à la demande, 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 Live TV, cette propriété est facultative. L'entité `BroadcastService` associée fournit le lien profond de la chaîne. Un `Movie` peut être disponible 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 capable d'identifier le film (par exemple, la page Wikipédia du film). Ce champ doit être différent 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. Par exemple : ["Action "Mode", "Environnement", "Football"]
`keywords`	Texte	Mots clés ou tags utilisés pour décrire ce contenu. Délimitez plusieurs entrées à l'aide de virgules. Par exemple, les mots clés "description" et "biographie" peuvent être utilisés pour décrire le contenu.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement recommandé Pourquoi ? – Une `PublicationEvent` est utilisée pour préciser la sortie originale (monde ou mondiale) d'un contenu par un éditeur, comme la date de sortie originale en salles d'un film. Utilisez également `FeaturedEvent` pour indiquer que votre service commercialise ce contenu en tant que contenu original, spécial, spécial, etc. `ExclusiveEvent` indique que votre service dispose de droits de distribution exclusifs et inclut où et quand. Consultez la section dédiée pour obtenir des détails et des exemples.
`releasedEvent.@type`	Texte	Obligatoire : veillez à toujours définir cette propriété sur l'une des valeurs suivantes : `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Pays	Obligatoire : région associée à 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 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 une `PublicationEvent`, il s'agit de la date de sortie initiale de cette entité, telle que la date de sortie du film en salle. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début de l'exclusivité ou de la présentation de l'entité.
`releasedEvent.endDate`	Date ou DateTime	Recommandé : Obligatoire pour `ExclusiveEvent` : applicable uniquement 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 met en avant l'entité. Si le contenu est exclusif ou présenté en permanence, définissez la valeur `endDate` sur 20 ans à partir de la date actuelle.
`releasedEvent.publishedBy`	Organisation ou personne	Facultatif : organisation ou personne qui a publié cette entité.
`description`	Texte	Fortement recommandé Pourquoi ? Synopsis du film Les synopsis des graphiques sont préférables aux résumés factuels. 300 caractères maximum. Utilisez un tableau pour baliser la description dans plusieurs langues. Consultez l'exemple Plusieurs régions et langues.
`duration`	Durée	Durée d'exécution du film au format ISO 8601. Veuillez utiliser le format suivant: "PT00H00M".
`director`	Personne	Fortement recommandé Pourquoi ? Réalisateur du film.
`actor`	Personne	Fortement recommandé Pourquoi ? Le ou les acteurs du film.
`producer`	Organisation ou personne	Fortement recommandé Pourquoi ? Producteur du film.
`image`	ImageObject	Obligatoire pour Google TV : images liées au film. Pour en savoir plus sur les propriétés obligatoires et facultatives à inclure avec `image`, consultez la section Propriétés d'image.
`trailer.description`	Texte	Description de la bande-annonce. Consultez l'exemple de la 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 des studios de production ou des sources autorisées respectifs.
`trailer.regionsAllowed`	Établissement	Régions où le contenu multimédia est autorisé. Si elle n'est pas spécifiée, elle est considérée comme autorisée partout. Indiquez les pays au format ISO 3166.
`identifier`	PropertyValue	Fortement recommandé Pourquoi ? - ID externe ou autre qui identifie sans ambiguïté cette entité. Plusieurs identifiants sont autorisés. Pour en savoir plus, consultez la section Propriétés des identifiants.
`review`	Avis	Avis sur le film
`review.reviewRating`	Note	Obligatoire si l'examen est fourni. Elle permet de spécifier la note attribuée à l'avis.
`contentRating`	Texte ou Note	Obligatoire pour le contenu réservé aux adultes, vivement 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 : Organisme de classification préfixé par un espace blanc. Par exemple, une classification "MP-13" de l'agence "MPAA" des États-Unis doit être décrite comme "MPAA PG-13". Consultez la liste des agences. La valeur "NOT NOT KNOWN"" (non sensible à la casse) indique que vous ne connaissez pas la classification du film.
`contentRating.author`	Texte ou Organisation	Obligatoire si `contentRating` utilise `Rating` : nom de l'organisme d'évaluation.
`contentRating.ratingValue`	Texte	Obligatoire si `contentRating` utilise `Rating` : valeur de la note.
`contentRating.advisoryCode`	Texte	Code de notification pour le contenu. Valeurs acceptées : D, FV, L, S et V. D = Dialogue, FV = violence fictive, L = Language, S = Contenu à caractère sexuel, V = Violence.
`popularityScore`	PopularitéScoreScore	Fortement recommandé Pourquoi ? Score que Google utilise, ainsi que d'autres signaux, pour déterminer le contenu multimédia à lire pour les 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 entre vos flux, parmi 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 indiquant la popularité de l'entité. Un score élevé signifie une plus grande popularité.
`popularityScore.eligibleRegion`	Pays	Région(s) dans laquelle le niveau de popularité s'applique. Si le niveau de popularité est applicable dans le monde entier, définissez la valeur sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité selon les paramètres régionaux 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 le visionnage à domicile. `Theatrical Release` : version disponible au cinéma. `International Release`: version modifiée pour une sortie internationale. `Remastered` : version dont les images, le son ou les deux ont été améliorés pour respecter une norme plus récente. `Unrated` : version qui n'a pas été présélectionnée par la MPAA ou une agence similaire. `Director Cut` : version qui représente la modification approuvée par le réalisateur. `Extended Cut`: version plus longue que la sortie en salles.
`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 la 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`. 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 film d'une version donnée. Définissez la catégorie sur l'une des valeurs suivantes : `Home Release` : version vendue ou louée pour le visionnage à domicile. `Theatrical Release` : version disponible au cinéma. `International Release` : version modifiée pour une sortie internationale. `Remastered`: version dont les images, le son ou les deux ont été améliorés pour respecter une norme plus récente. `Unrated`: version qui n'a pas été présélectionnée par la MPAA ou une agence similaire. `Director Cut`: version qui représente la modification approuvée par le réalisateur. `Extended Cut` : version plus longue que la sortie en salles.

Exemple

Film principal

Film avec une version longue.

{
  "@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"
}

Propriétés de balisage de contenu des films

Table des spécifications

Exemple

Film principal

Variante de coupe étendue

À lire également