Proprietà del markup dei contenuti dei film

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"}]
  • Dove" xx" rappresenta la lingua delle stringhe nel feed. Ogni contesto di entità principale deve avere il proprio campo @language impostato sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, si presume che i nomi siano in spagnolo anche se la lingua dei sottotitoli e del doppiaggio è in inglese.
@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:
  • Univoco a livello globale nel tuo catalogo
  • Statica; L'ID deve essere stabile e non cambiare nel tempo (anche se la proprietà url del podcast cambia). Verrà trattata come una stringa opaca e non deve essere necessariamente un link funzionante.
  • Sotto forma di URI (Unified Resource Identifier)
  • Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.
Poiché il valore 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:
  • url deve essere univoco a livello globale
  • url deve contenere un URL canonico funzionante di cui Google possa eseguire la scansione.
Per il link diretto della riproduzione, vedi invece la proprietà urlTemplate dell'oggetto target.
name Testo Obbligatorio: il nome del film.
  • Utilizza un array per elencare i nomi in lingue diverse. Vedi l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
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.
  • Se i contenuti sono disponibili su Video on Demand (VoD), questa proprietà è obbligatoria; l'oggetto markup dell'azione deve fornire il link diretto dei contenuti.
  • Se i contenuti sono disponibili su un canale LiveTV, questa proprietà è facoltativa. l'entità BroadcastService associata fornisce invece il link diretto del canale.
  • Un Movie può essere disponibile sia su VOD e LiveTV.
Utilizza un array per specificare link diretti diversi in più regioni. Vedi l'esempio Più regioni e lingue.
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:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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.
  • Utilizza un array per eseguire il markup della descrizione in più lingue. Vedi l'esempio Più regioni e lingue.
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:
  • L'agenzia di classificazione è stata preceduta da uno spazio vuoto. Ad esempio, "PG-13" valutazione dell'agenzia "MPAA" negli Stati Uniti deve essere descritto come "MPAA PG-13". Consulta l'elenco delle agenzie.
  • Il valore "RATING NOT KNOWN" (senza distinzione tra maiuscole e minuscole) per indicare che non conosci la classificazione del film.
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:
  • Home Release: una versione venduta o noleggiata per la visualizzazione domestica.
  • Theatrical Release: una versione rilasciata nei cinema.
  • International Release: una versione modificata per la pubblicazione a livello internazionale.
  • Remastered: una versione le cui immagini, audio o entrambi sono stati migliorati per ottenere uno standard più aggiornato.
  • Unrated: una versione non verificata dalla MPAA o da un'agenzia simile.
  • Director Cut: una versione che rappresenta la modifica approvata dal regista.
  • Extended Cut: una versione di durata superiore a quella dell'uscita nelle sale cinematografiche.
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:
  • Home Release: una versione venduta o noleggiata per la visualizzazione domestica.
  • Theatrical Release: una versione rilasciata nei cinema.
  • International Release: una versione modificata per la pubblicazione a livello internazionale.
  • Remastered: una versione le cui immagini, audio o entrambi sono stati migliorati per ottenere uno standard più aggiornato.
  • Unrated: una versione non verificata dalla MPAA o da un'agenzia simile.
  • Director Cut: una versione che rappresenta la modifica approvata dal regista.
  • Extended Cut: una versione di durata superiore a quella dell'uscita nelle sale cinematografiche.

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"
}

Consulta le seguenti pagine per gli argomenti relativi a queste proprietà: