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 : toujours défini sur ["http://schema.org", {"@language": "xx"}]
|
@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 répondre aux exigences suivantes :
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 répondre aux exigences suivantes :
urlTemplate de l'objet target. |
name |
Texte | Obligatoire : nom du film.
|
titleEIDR |
Texte | Fortement recommandé Pourquoi ? - Un EIDR (Entertainment Identifier Registry) représentant, au niveau le plus général/abstrait, une œuvre cinématographique ou télévisuelle. Par exemple, l'EIDR du titre 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 ou une édition spécifique d'une œuvre cinématographique ou télévisuelle. Par exemple, le film "Ghostbusters" dont l'EIDR du titre 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 editEIDR est fourni. |
potentialAction |
WatchAction | Obligatoire, le cas échéant : un 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 permettant d'identifier le film (par exemple, la page Wikipédia du film). Elle doit être différente de la propriété url. |
inLanguage |
Texte | Fortement recommandé : langue d'origine du film au format BCP 47. |
genre |
Texte | Liste ordonnée de tous les genres concernés. 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, ["feature, biography"] peut être un tableau de mots clés décrivant 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 en salle d'un film.De plus, utilisez FeaturedEvent pour indiquer que votre service commercialise ce contenu comme un contenu original, mis en avant, spécial, etc.ExclusiveEvent indique que votre service dispose des droits de distribution exclusifs, et précise où et quand.Pour en savoir plus et obtenir des exemples, consultez la section des exemples. |
releasedEvent.@type |
Texte | Obligatoire : veillez à toujours définir cette propriété sur l'une des valeurs suivantes :
|
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 les codes ISO 3166 pour les pays. Pour indiquer tous les pays du 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 cette entité, par exemple la date à laquelle un film est sorti pour la première fois au cinéma.Pour ExclusiveEvent et FeaturedEvent, il s'agit de la date de début de l'exclusivité ou de la mise en avant de l'entité. |
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 met en avant l'entité.Si le contenu est exclusif ou mis en avant de manière permanente, 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 résumés d'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(s) 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 Propriétés des images. |
trailer.description |
Texte | Description de la bande-annonce. Consultez l'exemple Bande-annonce. |
trailer.inLanguage |
Texte | Fortement recommandé : langue de la bande-annonce au format BCP 47. |
trailer.url |
URL | URL d'une bande-annonce hébergée publiquement et importée par les studios de production concernés ou des sources autorisées. |
trailer.regionsAllowed |
Place | Régions dans lesquelles le contenu multimédia est autorisé. Si cette information n'est pas spécifiée, la vidéo est considérée comme autorisée 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 des identifiants. |
review |
Avis | Notes des avis sur le film |
review.reviewRating |
Note | Obligatoire si un avis est fourni. Cela permet de spécifier la note attribuée dans 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 fournie sous la forme d'une chaîne de texte, deux variantes sont acceptées :
|
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 classification. |
contentRating.advisoryCode |
Texte | Code d'avertissement pour le contenu. Les valeurs acceptées sont D, FV, L, S et V. D = Dialogue, FV = Violence fictive, L = Langage, S = Contenu à caractère sexuel, V = Violence. |
popularityScore |
PopularityScoreSpecification | Fortement recommandé 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 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 indiquant la popularité de l'entité. Plus le score est élevé, plus la popularité est élevée. |
popularityScore.eligibleRegion |
Pays | Région(s) où ce score de popularité est applicable. Si le score de popularité est applicable au niveau mondial, définissez-le sur EARTH. Par défaut, cette propriété est définie sur EARTH. Note: La popularité spécifique à une langue prévaut sur la popularité mondiale (TERRE) |
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 :
|
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 : 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 variante du film pour 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 version longue
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 en savoir plus sur les thèmes liés à ces propriétés :