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

Propriétés de balisage de contenu des films

Cette section fournit les détails des 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 dans le flux. Le champ @language de chaque contexte d'entité racine doit correspondre au code de langue approprié, au format BCP 47. Par exemple, si la langue est définie sur espagnol, les noms sont supposés être 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 global dans votre catalogue Statique ; l'identifiant doit être stable et immuable dans le temps (même si la propriété URL est modifiée). Elle est traitée comme une chaîne opaque et ne doit donc pas nécessairement être un lien fonctionnel. Sous la forme d'un 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`. Consultez la section Identifiant pour en savoir plus.
`url`	URL	Obligatoire : URL canonique du contenu, que Google utilise pour mettre en correspondance le contenu de votre flux avec les bases de données de Google. `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 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 pourquoi - Identifiant EIDR (Entertainment Identifier Registry) représentant, de manière générale ou abstraite, une œuvre cinématographique ou télévisée. Par exemple, le titreEIDR du film "Ghostbusters" est "10.5240/7EC7-228A-510A-053E-CBB8-J".
`editEIDR`	Texte	Fortement pourquoi - Identifiant EIDR (Entertainment Identifier Registry) représentant le montage ou l'édition d'un film ou d'une série TV. ? La propriété `titleEIDR` est obligatoire lorsque l'élément EditEIDR 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 dans la vidéo à 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 de télévision en direct, cette propriété est facultative. L'entité `BroadcastService` associée fournit le lien profond de la chaîne. Une `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 pourquoi URL d'une page Web de référence pouvant identifier le film (par exemple, sa page Wikipédia) Il 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. Un tableau de mots clés est également autorisé. Par exemple, ["fonctionnalité, biographie"] peut être un tableau de mots clés décrivant le contenu.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Fortement pourquoi - Un élément `PublicationEvent` permet de spécifier la sortie d'un film original (dans le monde entier ou en magasin), par exemple la date de sortie initiale d'un film. Utilisez également `FeaturedEvent` pour indiquer que votre service présente ce contenu en tant que contenu original, mis en avant, spécial, etc. `ExclusiveEvent` spécifie que votre service dispose de droits de distribution exclusifs, et précise où et quand. Voir la section 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`	Country	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 dans laquelle le contenu est présenté ou exclusif. Utilisez les codes ISO 3166 pour les pays. Pour indiquer n'importe où 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 un `PublicationEvent`, il s'agit de la date de sortie initiale de l'entité, telle que la date de sortie du film au cinéma. Pour `ExclusiveEvent` et `FeaturedEvent`, il s'agit de la date de début 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 à laquelle les droits sur le contenu expirent. Pour `FeaturedEvent`, il s'agit de la dernière date à laquelle le fournisseur met en avant l'entité. Si le contenu est définitivement exclu ou sélectionné, définissez la valeur `endDate` sur 20 ans à compter de la date actuelle.
`releasedEvent.publishedBy`	Organisation ou Person	Facultatif : organisation ou personne qui a publié cette entité.
`description`	Texte	Fortement pourquoi Résumé du film. Il est préférable d'utiliser des résumés de l'intrigue plutôt que des 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 pourquoi Réalisateur du film.
`actor`	Personne	Fortement pourquoi Membres du casting du film
`producer`	Organisation ou Person	Fortement pourquoi Le ou les producteurs 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 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 de la bande-annonce hébergée publiquement et mise en ligne par les studios de production ou les sources autorisées.
`trailer.regionsAllowed`	Établissement	Régions où le contenu multimédia est autorisé. Si aucune valeur n'est spécifiée, il est considéré comme autorisé partout. Spécifiez les pays au format ISO 3166.
`identifier`	PropertyValue	Fortement 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 des identifiants.
`review`	Avis	Classification du film
`review.reviewRating`	Rating	Obligatoire si un avis est fourni. Cette information permet de spécifier la note attribuée à l'avis.
`contentRating`	Texte ou Note	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 définie sous la forme d'une chaîne de texte, deux variantes sont acceptées: L'agence d'évaluation a ajouté un préfixe à la note, avec un espace blanc entre les deux. Par exemple, la classification "MPAA-MP3" pour l'agence américaine "MPAA" aux États-Unis doit être définie 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 note 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 consultatif du contenu. Valeurs acceptées : D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langue, S = Contenu à caractère sexuel, V = Violence.
`popularityScore`	PopularitéScoreScore	Fortement pourquoi Score utilisé par Google, 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 les flux de 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é. Plus le score est élevé, plus la popularité est élevée.
`popularityScore.eligibleRegion`	Country	Région(s) dans laquelle ce score de popularité s'applique. Si le niveau de popularité est valable dans le monde entier, définissez cette option sur `EARTH`. Par défaut, cette propriété est définie sur `EARTH`. `Note:` La popularité propre aux paramètres régionaux est prioritaire sur la popularité mondiale (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 publiée en salle. `International Release`: version modifiée pour une publication internationale. `Remastered`: version dont les images, le son ou les deux ont été améliorés pour respecter une norme plus à jour. `Unrated`: version qui n'a pas été sélectionnée par la MPAA ni par une agence similaire. `Director Cut`: version qui représente la modification approuvée par le réalisateur. `Extended Cut`: version plus longue que la version cinéma.
`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 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 : cette valeur est toujours définie sur `Movie`. Cela peut être représenté sous la forme d'un 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 la variante de film d'une version particulière. Définissez la catégorie sur l'une des options suivantes: `Home Release`: version vendue ou louée pour un visionnage à domicile. `Theatrical Release`: version publiée en salle. `International Release`: version modifiée pour une publication internationale. `Remastered`: version dont les images, le son ou les deux ont été améliorés pour respecter une norme plus à jour. `Unrated`: version qui n'a pas été sélectionnée par la MPAA ni par une agence similaire. `Director Cut`: version qui représente la modification approuvée par le réalisateur. `Extended Cut`: version plus longue que la version cinéma.

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