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 - Imposta sempre su ["http://schema.org", {"@language": "xx"}]
|
@type |
Testo | Obbligatorio - Imposta sempre 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 il valore 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 abbinare i contenuti del tuo feed ai contenuti nei database di Google.url deve soddisfare i seguenti requisiti:
urlTemplate dell'oggetto target. |
name |
Testo | Obbligatorio: il nome del film.
|
titleEIDR |
Testo | Altamente consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, a livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, titleEIDR per un film noto come "Ghostbusters" è "10.5240/7EC7-228A-510A-053E-CBB8-J". |
editEIDR |
Testo | Altamente consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta un montaggio / un'edizione specifica di un film o un programma televisivo. Ad esempio, il film noto come "Ghostbusters" il cui titolo EIDR è "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 un Modifica EIDR. |
potentialAction |
WatchAction | Obbligatorio se applicabile: un oggetto di markup dell'azione che fornisce i dettagli dell'azione.
|
sameAs |
URL | Altamente consigliato Perché? Un URL a una pagina web di riferimento in grado di identificare il film. ad esempio la pagina Wikipedia del film. Deve essere diverso dalla proprietà url. |
inLanguage |
Testo | 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, ["caratteristica, biografia"] può essere un insieme di parole chiave per descrivere i contenuti. |
releasedEvent |
PublicationEvent, FeaturedEvent o ExclusiveEvent |
Altamente consigliato Perché? - Viene utilizzato un PublicationEvent per specificare la pubblicazione originale (globale o locale) dei contenuti di un editore, ad esempio la data di uscita nei cinema originali 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 indica che il tuo servizio ha diritti di distribuzione esclusivi e include dove e quando.Consulta la sezione degli esempi per dettagli ed esempi. |
releasedEvent.@type |
Testo | Obbligatorio - Assicurati di impostare sempre questa proprietà su uno dei seguenti valori:
|
releasedEvent.location |
Paese | Obbligatorie: le regioni associate a questo evento. Per PublicationEvent, questa è la regione in cui sono stati pubblicati i contenuti.Per FeaturedEvent e ExclusiveEvent, questa è la regione in cui i contenuti vengono messi in primo piano o in esclusiva.Utilizza i codici ISO 3166 per i paesi. Per indicarlo ovunque nel mondo, imposta EARTH. |
releasedEvent.startDate |
Date 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 la data in cui il film è stato pubblicato per la prima volta nei cinema.Per ExclusiveEvent e FeaturedEvent, rappresenta la data di inizio in cui l'entità diventa esclusiva o viene messa in primo piano. |
releasedEvent.endDate |
Date o DateTime | Consigliato - Obbligatorio per ExclusiveEvent: applicabile solo ai tipi ExclusiveEvent e FeaturedEvent.Per ExclusiveEvent, rappresenta la data di scadenza dei diritti relativi ai contenuti.Per FeaturedEvent, rappresenta l'ultima data in cui il fornitore mette in primo piano l'entità.Se i contenuti sono in primo piano o esclusivi per sempre, imposta endDate su 20 anni dalla data corrente. |
releasedEvent.publishedBy |
Organization o Person | Facoltativo - L'organizzazione o la persona che ha pubblicato questa entità. |
description |
Testo | Altamente consigliato Perché? Una sinossi del film. È preferibile optare per le sinossi dei lotti piuttosto che per i riepiloghi oggettivi. Limite di 300 caratteri.
|
duration |
Durata | Tempo di esecuzione del filmato in formato ISO 8601. Utilizza il formato: "PT00H00M". |
director |
Person | Altamente consigliato Perché? I registi del film. |
actor |
Person | Altamente consigliato Perché? I membri del cast del film. |
producer |
Organization o Person | Altamente consigliato Perché? I produttori del film. |
image |
ImageObject | Obbligatorio per Google TV: le immagini relative al film. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere in image, consulta la sezione Proprietà delle immagini. |
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 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 nel formato ISO 3166. |
identifier |
PropertyValue | Altamente consigliato Perché? - ID esterno o di altro tipo che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per informazioni dettagliate, consulta la sezione Proprietà dell'identificatore. |
review |
Review | Recensisci le classificazioni relative al film |
review.reviewRating |
Valutazione | Obbligatorio se viene fornita la revisione. Viene utilizzato per specificare la valutazione fornita nella recensione. |
contentRating |
Testo o Valutazione | 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 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 = Linguaggio, S = Contenuti di natura sessuale, V = Violenza. |
popularityScore |
PopularityScoreSpecification | Altamente consigliato Perché? Punteggio utilizzato da Google, 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 in tutti i feed, tra tutte le entità nel 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 corrisponde a una maggiore popolarità. |
popularityScore.eligibleRegion |
Paese | Regioni in cui è applicabile il 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 località ha la precedenza sulla popolarità globale (EARTH) |
category |
Testo | Obbligatorio se applicabile: compila questa proprietà se l'entità è una variante Movie. Imposta category su una delle seguenti opzioni:
|
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 valore @id dell'entità Movie di cui è una variante. |
workExample.@type |
Testo | Obbligatorio - Imposta sempre su Movie. Può essere rappresentato come un array per un elemento 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 di un film di una determinata versione. Imposta la categoria su una delle seguenti opzioni:
|
Esempio
Film principale
Un film con una variante di 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 con taglio esteso
La versione integrale 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à: