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"}]
|
@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 :
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 :
urlTemplate de l'objet cible. |
name |
Texte | Obligatoire : nom du film.
|
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.
|
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 :
|
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.
|
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 :
|
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 :
|
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 :
|
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"
}
À lire également
Consultez les pages suivantes pour les sujets liés à ces propriétés: