Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per il tipo di entità Movie.
Tabella delle specifiche
| Proprietà | Tipo previsto | Descrizione |
|---|---|---|
@context |
Testo | Obbligatorio: sempre impostato su ["http://schema.org", {"@language": "xx"}]
|
@type |
Testo | Obbligatorio: sempre impostato su Movie per i film. |
@id |
URL | Obbligatorio: l'identificatore dei contenuti in formato URI, ad esempio https://example.com/1234abc.@id deve soddisfare i seguenti requisiti:
url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore. |
url |
URL | Obbligatorio: l'URL canonico dei contenuti, che Google utilizza per associare i contenuti del feed a quelli dei database di Google.url deve soddisfare i seguenti requisiti:
urlTemplate dell'oggetto target. |
name |
Testo | Obbligatorio: il titolo del film.
|
titleEIDR |
Testo | Consigliato. Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, al livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, il titolo EIDR del film "Ghostbusters" è "10.5240/7EC7-228A-510A-053E-CBB8-J". |
editEIDR |
Testo | Consigliato. Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta una modifica / edizione specifica di un'opera cinematografica o televisiva. Ad esempio, il film "Ghostbusters", il cui EIDR del titolo è "10.5240/7EC7-228A-510A-053E-CBB8-J", ha diverse modifiche, ad esempio "10.5240/1F2A-E1C5-680A-14C6-E76B-I" e "10.5240/8A35-3BEE-6497-5D12-9E4F-3". La proprietà titleEIDR è obbligatoria quando viene fornito editEIDR. |
potentialAction |
WatchAction | Obbligatorio se applicabile: un oggetto di markup dell'azione che fornisce i dettagli dell'azione.
|
sameAs |
URL | Consigliato. Perché? Un URL a una pagina web di riferimento che può identificare il film, ad esempio la pagina di Wikipedia del film. Deve essere diverso dalla proprietà url. |
inLanguage |
Testo | Altamente consigliato: lingua originale del film nel formato BCP 47. |
genre |
Testo | Un elenco ordinato di tutti i generi pertinenti. Ad esempio : ["Azione", "Moda", "Ambiente", "Calcio"] |
keywords |
Testo | Parole chiave o tag utilizzati per descrivere questi contenuti. È consentito anche un array di parole chiave. Ad esempio, ["feature, biography"] può essere un array di parole chiave per descrivere i contenuti. |
releasedEvent |
PublicationEvent, FeaturedEvent o ExclusiveEvent |
Consigliato. Perché? - Una PublicationEvent viene utilizzata per specificare la pubblicazione originale (globale o locale) dei contenuti da parte di un editore, ad esempio la data di uscita cinematografica originale di un film.Inoltre, utilizza FeaturedEvent per indicare che il tuo servizio commercializza questi contenuti come originali, in primo piano, speciali e così via.ExclusiveEvent specifica che il tuo servizio dispone dei diritti di distribuzione esclusiva e include dove e quando.Per dettagli ed esempi, consulta la sezione Esempio. |
releasedEvent.@type |
Testo | Obbligatorio: assicurati di impostare sempre questa proprietà su uno dei seguenti valori:
|
releasedEvent.location |
Paese | Obbligatorio: le regioni associate a questo evento. Per un PublicationEvent, questa è la regione in cui sono stati pubblicati i contenuti.Per FeaturedEvent e ExclusiveEvent, questa è la regione in cui i contenuti sono in evidenza o esclusivi.Utilizza i codici ISO 3166 per i paesi. Per indicare ovunque nel mondo, imposta EARTH. |
releasedEvent.startDate |
Date o DateTime | Consigliato - Obbligatorio per ExclusiveEvent - La data di inizio della pubblicazione dell'entità.Per un PublicationEvent, indica la data di uscita iniziale dell'entità, ad esempio la data di uscita di un film nelle sale cinematografiche.Per ExclusiveEvent e FeaturedEvent, rappresenta la data di inizio del periodo di esclusiva o di messa in evidenza dell'entità. |
releasedEvent.endDate |
Date o DateTime | Consigliato - Obbligatorio per ExclusiveEvent - Questo valore è applicabile solo ai tipi ExclusiveEvent e FeaturedEvent.Per ExclusiveEvent, rappresenta la data di scadenza dei diritti sui contenuti.Per FeaturedEvent, rappresenta l'ultima data in cui il fornitore mette in evidenza l'entità.Se i contenuti sono in esclusiva o in evidenza perpetua, imposta endDate su 20 anni dalla data attuale. |
releasedEvent.publishedBy |
Organization o Person | (Facoltativo): l'organizzazione o la persona che ha pubblicato questa entità. |
description |
Testo | Consigliato. Perché? Una sinossi del film. Sono preferite le sinossi della trama ai riassunti fattuali. Limite di 300 caratteri.
|
duration |
Durata | Durata del film in formato ISO 8601. Utilizza il formato "PT00H00M". |
director |
Person | Consigliato. Perché? Il regista o i registi del film. |
actor |
Person | Consigliato. Perché? Gli attori del film. |
producer |
Organization o Person | Consigliato. Perché? Il produttore o i produttori del film. |
image |
ImageObject | Obbligatorio per Google TV: le immagini correlate al film. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere in image, consulta Proprietà immagine. |
trailer.description |
Testo | La descrizione del trailer. Vedi l'esempio di trailer. |
trailer.inLanguage |
Testo | Consigliato. La lingua del trailer nel formato BCP 47. |
trailer.url |
URL | Un URL di un trailer ospitato pubblicamente e caricato dai rispettivi studi di produzione o da fonti autorizzate. |
trailer.regionsAllowed |
Luogo | Le regioni in cui i contenuti multimediali sono consentiti. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi in formato ISO 3166. |
identifier |
PropertyValue | Consigliato. Perché? - ID esterno o altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per i dettagli, consulta la sezione Proprietà identificatore. |
review |
Review | Rivedere le valutazioni del film |
review.reviewRating |
Valutazione | Obbligatorio se viene fornita una recensione. Viene utilizzato per specificare la valutazione attribuita nella recensione. |
contentRating |
Text o Rating | Obbligatorio per i contenuti per adulti, vivamente consigliato altrimenti Perché? - Classificazione complessiva dei contenuti. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti:
|
contentRating.author |
Organizzazione | Obbligatorio se contentRating utilizza Rating: il nome dell'agenzia di classificazione. |
contentRating.ratingValue |
Testo | Obbligatorio se contentRating utilizza Rating: il valore della classificazione. |
contentRating.advisoryCode |
Testo | Il codice di avvertenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogue, FV = Fantasy Violence , L = Language, S = Sexual Content, V = Violence. |
popularityScore |
PopularityScoreSpecification | Consigliato. Perché? Un punteggio che Google utilizza, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo, pertanto la scala del punteggio deve essere coerente nei tuoi feed, tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0. |
popularityScore.@type |
Testo | Sempre impostato su PopularityScoreSpecification. |
popularityScore.value |
Number | Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto indica una maggiore popolarità. |
popularityScore.eligibleRegion |
Paese | La regione o le regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su EARTH. Per impostazione predefinita, questa proprietà è impostata su EARTH. Note: La popolarità specifica per la località ha la precedenza su quella globale (TERRA) |
category |
Testo | Obbligatorio se applicabile: compila questa proprietà se l'entità è una variante di Movie. Imposta category su uno dei seguenti valori:
|
workExample |
Film | Specifica le varianti del film. Includi questa proprietà nell'entità Movie principale, non nelle entità Movie per le versioni delle varianti. |
workExample.@id |
URL | Per le varianti Movie, questa proprietà fornisce il @id dell'entità Movie di cui è una variante. |
workExample.@type |
Testo | Obbligatorio: sempre impostato su Movie. Può essere rappresentato come un array per un Movie con più varianti. |
workExample.@id |
URL | Obbligatorio: il @id della variante Movie. |
workExample.name |
Testo | Obbligatorio: il nome della variante Movie. |
workExample.category |
Testo | Obbligatorio: il tipo di variante del film di una determinata versione. Imposta la categoria su una delle seguenti:
|
Esempio
Film principale
Un film con una variante in versione estesa.
{
"@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 di taglio estesa
La versione extended cut del film principale.
{
"@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"
}
Pagine correlate
Consulta le seguenti pagine per gli argomenti correlati a queste proprietà: