Questa sezione fornisce i dettagli delle proprietà del 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 del contenuto 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 la proprietà url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore. |
url |
URL | Obbligatorio: l'URL canonico dei contenuti, utilizzato da Google per abbinare i contenuti nel tuo feed a quelli nei database di Google.url deve soddisfare i seguenti requisiti:
urlTemplate dell'oggetto target. |
name |
Testo | Obbligatorio: il nome del film.
|
titleEIDR |
Testo | Fortemente consigliatoPerché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta al livello più generale/astratto un'opera cinematografica o televisiva. Ad esempio, titletitle per il film noto come "Ghostbusters" è "10.5240/7EC7-228A-510A-053E-CBB8-J". |
editEIDR |
Testo | Fortemente consigliatoPerché? - Un identificatore EIDR (Intrattenimento Identifier Registry) che rappresenta un'edizione o un'edizione specifica di un'opera cinematografica o televisiva. Ad esempio, il film noto come "Ghostbusters" con il titolo "10.5240/7EC7-228A-510A-053E-CBB8-J" presenta diverse modifiche, ad esempio "10.5240/1F2A-E1C5-680A-14C6-E76B-I5"-5-7.3.7.3.4.7.3.4.7.0.3.0.3.0.3 La proprietà titleEIDR è obbligatoria quando viene fornito il parametro editEIDR. |
potentialAction |
WatchAction | Obbligatorio se applicabile: un oggetto di markup dell'azione che fornisce i dettagli dell'azione.
|
sameAs |
URL | Fortemente consigliatoPerché? Un URL che rimanda a una pagina web di riferimento che può identificare il film, ad esempio la pagina Wikipedia del film. Deve essere diverso dalla proprietà url. |
inLanguage |
Testo | Lingua originale del film in 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, ["funzionalità", biografia"] può essere un array di parole chiave per descrivere i contenuti. |
releasedEvent |
PublicationEvent, FeaturedEvent o ExclusiveEvent |
Fortemente consigliatoPerché? - Un PublicationEvent viene utilizzato per specificare l'uscita originale (globale o locale) dei contenuti 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 ha diritti di distribuzione esclusivi e include dove e quando.Consulta la sezione di esempio per dettagli ed esempi. |
releasedEvent.@type |
Testo | Obbligatorio: assicurati di impostare sempre questa proprietà su una delle seguenti opzioni:
|
releasedEvent.location |
Paese | Obbligatorio: le regioni associate a questo evento. Per PublicationEvent, si tratta della regione in cui i contenuti sono stati pubblicati.Per FeaturedEvent e ExclusiveEvent, si tratta della regione in cui i contenuti sono in primo piano o esclusivi.Utilizza i codici ISO 3166 per i paesi. Per indicare ovunque nel mondo, imposta su EARTH. |
releasedEvent.startDate |
Data o DateTime | Consigliato: obbligatorio per ExclusiveEvent. La data di inizio della pubblicazione dell'entità.Per PublicationEvent, indica la data di uscita iniziale dell'entità, ad esempio quella in cui il film è stato pubblicato per la prima volta nelle sale.Per ExclusiveEvent e FeaturedEvent, questo valore rappresenta la data di inizio del periodo in cui l'entità è esclusiva o in primo piano. |
releasedEvent.endDate |
Data o DateTime | Consigliato: obbligatorio per ExclusiveEvent. Si applica solo ai tipi ExclusiveEvent e FeaturedEvent.Per ExclusiveEvent, rappresenta la data di scadenza dei diritti dei contenuti.Per FeaturedEvent, rappresenta l'ultima data in cui il provider include l'entità.Se i contenuti sono perennemente esclusivi o in primo piano, imposta endDate su 20 anni dalla data corrente. |
releasedEvent.publishedBy |
Organizzazione o Persona | Facoltativo: l'organizzazione o la persona che ha pubblicato questa entità. |
description |
Testo | Fortemente consigliatoPerché? Una sinossi del film. Per le sintesi dei grafici è preferibile utilizzare riepiloghi dei fatti. 300 caratteri.
|
duration |
Durata | Durata del filmato in formato ISO 8601. Utilizza il formato: "PT00H00M". |
director |
Person | Fortemente consigliatoPerché? Il regista o i film del film. |
actor |
Person | Fortemente consigliatoPerché? I membri del cast del film. |
producer |
Organizzazione o Persona | Fortemente consigliatoPerché? Il produttore o i produttori del film. |
image |
ImageObject | Obbligatorio per Google TV: le immagini relative al film. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere in image, consulta le proprietà dell'immagine. |
trailer.description |
Testo | La descrizione del trailer. Vedi l'esempio del trailer. |
trailer.inLanguage |
Testo | La lingua del trailer nel formato BCP 47. |
trailer.url |
URL | L'URL di un trailer ospitato pubblicamente e caricato da rispettive case di produzione o fonti autorizzate. |
trailer.regionsAllowed |
Luogo | Le regioni in cui sono consentiti i contenuti multimediali. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi in formato ISO 3166. |
identifier |
PropertyValue | Fortemente consigliatoPerché? - ID esterno o un altro ID che identifica in modo univoco questa entità. Sono ammessi più identificatori. Per ulteriori dettagli, consulta la sezione Proprietà degli identificatori. |
review |
Recensione | Classificazioni del film |
review.reviewRating |
Valutazione | Obbligatorio se viene fornita una revisione. Viene utilizzato per specificare la valutazione attribuita nella recensione. |
contentRating |
Testo o Valutazione | Obbligatorio per i contenuti per adulti, vivamente consigliato altrimenti Perché? - Valutazione complessiva dei contenuti. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti:
|
contentRating.author |
Testo o Organizzazione | Obbligatorio se contentRating utilizza Rating: il nome dell'agenzia di valutazione. |
contentRating.ratingValue |
Testo | Obbligatorio se contentRating utilizza Rating: il valore della valutazione. |
contentRating.advisoryCode |
Testo | Il codice di consulenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogo, FV = Violenza di fantasia, L = Lingua, S = Contenuti di natura sessuale, V = Violenza. |
popularityScore |
PopolaritàPunteggio Specifica | Fortemente consigliatoPerché? Punteggio utilizzato da Google e da altri indicatori per stabilire quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto agli altri contenuti del tuo catalogo. Pertanto, la scala del punteggio deve essere coerente con tutti i 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 | Imposta sempre su PopularityScoreSpecification. |
popularityScore.value |
Number | Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto significa maggiore popolarità. |
popularityScore.eligibleRegion |
Paese | Regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, imposta su EARTH. Per impostazione predefinita, questa proprietà è impostata su EARTH. Note: La popolarità specifica per locale ha la precedenza sulla popolarità a livello globale (EARTH) |
category |
Testo | Obbligatorio se applicabile: compila questa proprietà se l'entità è una variante 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 Movie varianti, questa proprietà fornisce l'entità @id dell'entità Movie di cui si tratta. |
workExample.@type |
Testo | Obbligatorio: sempre impostato su Movie. Può essere rappresentato come un array per un Movie con più varianti. |
workExample.@id |
URL | Obbligatorio: la variante @id della variante Movie. |
workExample.name |
Testo | Obbligatorio: il nome della variante Movie. |
workExample.category |
Testo | Obbligatorio: il tipo di variante cinematografica di una determinata versione. Imposta la categoria su una delle seguenti opzioni:
|
Esempio
Film principale
Film con una variante con taglio esteso.
{
"@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 taglio esteso
La versione estesa 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 relativi a queste proprietà: