Questa pagina è stata tradotta dall'API Cloud Translation.

Proprietà di markup dei contenuti di programmi TV

Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per i tipi di entità TVSeries, TVEpisode e TVSeason.

Fornire TVSeason come entità completa è facoltativo. Per maggiori dettagli, consulta la sezione Relazioni tra TVSeries, TVSeason e TVEpisode.

Tabella delle specifiche

TVSeries

Proprietà	Tipo previsto	Descrizione
`@context`	Testo	Obbligatorio: impostato sempre su `["http://schema.org", {"@language": "xx"}]` dove"xx" rappresenta la lingua delle stringhe nel feed. Per ogni contesto dell'entità principale, l'attributo @language deve essere 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/doppiaggio è l'inglese.
`@type`	Testo	Obbligatorio: impostato sempre su `TVSeries`.
`@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 L'ID deve essere stabile e non cambiare nel tempo (anche se la proprietà url del programma cambia). Verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di URI (Uniform Resource Identifier) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché il `url` di un'entità soddisfa tutti i requisiti di un identificatore, ti consigliamo di utilizzare il `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 tuo feed a quelli dei database di Google. `url` deve soddisfare i seguenti requisiti: `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante che Google può eseguire la scansione. Per il link diretto per la riproduzione, consulta la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome del programma. Utilizza un array per elencare i nomi in lingue diverse. Consulta l'esempio Più regioni e lingue. Tieni presente che è supportato un solo nome per impostazioni internazionali (coppia lingua-paese).
`titleEIDR`	Testo	Molto consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, a livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, il valore titleEIDR per la serie TV nota come "Il trono di spade" è "10.5240/C1B5-3BA1-8991-A571-8472-W".
`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 Action 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 `TVSeries` può essere disponibile sia su VoD che su Live TV. Utilizza un array per specificare link diretti diversi in più regioni. Consulta l'esempio Più regioni e lingue.
`sameAs`	URL	Molto consigliato Perché? L'URL di una pagina web di riferimento che può identificare il programma, ad esempio la pagina di Wikipedia del programma. Deve essere diverso dalla proprietà `url`.
`inLanguage`	Testo	Lingua originale della serie in formato BCP 47.
`genre`	Testo	Un elenco ordinato di tutti i generi pertinenti. Ad esempio : `["Action", "Fashion", "Environment", "Football"]`
`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`	Molto consigliato Perché? - Un `PublicationEvent` viene utilizzato per specificare la pubblicazione originale (globale o locale) dei contenuti da parte di un editore, ad esempio la data di uscita originale nelle sale cinematografiche 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 degli esempi per dettagli ed esempi.
`releasedEvent.@type`	Testo	Obbligatorio: assicurati di impostare sempre questa proprietà su una delle seguenti: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorio: le regioni associate a questo evento. Per un valore `PublicationEvent`, si tratta della regione in cui sono stati pubblicati i contenuti. 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 il valore `EARTH`.
`releasedEvent.startDate`	Data o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent`: la data di inizio della pubblicazione della persona giuridica. Per un `PublicationEvent`, indica la data di uscita iniziale della persona giuridica, ad esempio la data di prima uscita di un film nelle sale cinematografiche. Per `ExclusiveEvent` e `FeaturedEvent`, indica la data di inizio in cui la persona giuridica è in 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 sui contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il fornitore ha mostrato l'entità. Se i contenuti sono permanentemente esclusivi o in primo piano, 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	Molto consigliato Perché? Una sinossi del programma. Sono preferibili le sinossi della trama rispetto ai riepiloghi fattuali. Limite di 300 caratteri. Utilizza un array per eseguire il markup della descrizione in più lingue. Consulta l'esempio Più regioni e lingue.
`actor`	Person o PerformingGroup o PerformanceRole	Molto consigliato Perché? Un array dei membri del cast della serie. Consulta le indicazioni per la definizione del modello qui.
`director`	Person	Molto consigliato Perché? I registi del programma.
`producer`	Organization o Person	Molto consigliato Perché? I produttori del programma.
`image`	ImageObject	Obbligatorio per Google TV: le immagini relative alla serie TV. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere con `image`, consulta Proprietà immagine.
`trailer.description`	Testo	La descrizione del trailer. Guarda l'esempio Trailer.
`trailer.inLanguage`	Testo	La lingua del trailer in 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 in formato ISO 3166.
`identifier`	PropertyValue	Molto consigliato Perché? - ID esterno o un altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per maggiori dettagli, consulta la sezione Proprietà identificatore.
`popularityScore`	PopularityScoreSpecification	Molto consigliato Perché? Un 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 nei tuoi feed e tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
`popularityScore.@type`	Testo	Deve essere 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	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 località ha la precedenza sulla popolarità globale (EARTH)
`review`	Review	Rivedi le valutazioni della serie TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito `review`. Viene utilizzato per specificare la valutazione data nella recensione.
`contentRating`	Testo o Valutazione	Obbligatorio per i contenuti per adulti, vivamente consigliato in caso contrario: classificazione dei contenuti complessiva. Se la classificazione dei contenuti è fornita sotto forma di stringa di testo, sono accettate due varianti: L'agenzia di rating ha anteposto la valutazione con uno spazio vuoto in mezzo. Ad esempio, una classificazione "TV-MA" dell'agenzia "TVPG" negli Stati Uniti deve essere descritta come "TVPG TV-MA". Consulta l'elenco delle agenzie. Un valore "RATING NOT KNOWN" (sensibile alle maiuscole) per indicare che non conosci la classificazione dei contenuti.
`contentRating.author`	Organizzazione	Obbligatorio se `contentRating` utilizza `Rating`: il nome dell'agenzia di classificazione. Consulta la pagina Agenzie di classificazione dei contenuti per un elenco delle agenzie di classificazione accettate
`contentRating.ratingValue`	Testo	Obbligatorio se `contentRating` utilizza `Rating`: il valore della classificazione.
`contentRating.advisoryCode`	Testo	Il codice di avviso per i contenuti. I valori accettati sono D, FV, L, S e V. D = Dialoghi, FV = Violenza fantastica, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza.

TVEpisode

Proprietà	Tipo previsto	Descrizione
`@context`	Testo	Obbligatorio: impostato sempre su `["http://schema.org", {"@language": "xx"}]` dove"xx" rappresenta la lingua delle stringhe nel feed. Per ogni contesto dell'entità principale, l'attributo @language deve essere 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/doppiaggio è l'inglese.
`@type`	Testo	Obbligatorio: impostato sempre su `TVEpisode`.
`@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 L'ID deve essere stabile e non cambiare nel tempo (anche se la proprietà url del programma cambia). Verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di URI (Uniform Resource Identifier) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché il `url` di un'entità soddisfa tutti i requisiti di un identificatore, ti consigliamo di utilizzare il `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 tuo feed a quelli dei database di Google. `url` deve soddisfare i seguenti requisiti: `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante che Google può eseguire la scansione. Per il link diretto della riproduzione, consulta la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome della puntata. Utilizza un array per elencare i nomi in lingue diverse. Consulta l'esempio di rappresentazione in più lingue. Tieni presente che è supportato un solo nome per impostazioni internazionali (coppia lingua-paese).
`titleEIDR`	Testo	Molto consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, a livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, il valore titleEIDR per la prima puntata della prima stagione della serie TV nota come "Il trono di spade" è "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
`editEIDR`	Testo	Molto consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta una modifica / edizione specifica di un'opera cinematografica o televisiva. Ad esempio, la prima puntata della prima stagione della serie TV nota come "Il trono di spade", il cui titleEIDR è "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", ha un montaggio, ad esempio "10.5240/FB97-C847-2969-D0AB-ECD1-C". La proprietà `titleEIDR` è obbligatoria quando viene fornito editEIDR.
`inLanguage`	Testo	Lingua originale della serie in formato BCP 47.
`episodeNumber`	Intero	Obbligatorio: il numero che indica la posizione di questa puntata nell'ordine delle puntate di una stagione. `episodeNumber` deve essere riavviato per ogni stagione, ovvero la prima puntata di ogni stagione deve essere 1.
`partOfSeason`	TVSeason	Obbligatorio: la stagione TV a cui appartiene la puntata. Anche se un `TVEpisode` non ha un `TVSeason` corrispondente, devi comunque fornire le proprietà `partOfSeason.@id` e `partOfSeason.seasonNumber`. Una soluzione alternativa è: Prendi `partofSeries.@id` (ad es. http://www.example.com/my_favorite_tv_show) e aggiungi un campo di query segnaposto (ad es. ?season1) per creare un `partOfSeason.@id` univoco (ad es. http://www.example.com/my_favorite_tv_show?season1). Imposta `partOfSeason.seasonNumber` su 1.
`partOfSeason.@type`	Testo	Obbligatorio: impostato sempre su `TVSeason`.
`partOfSeason.@id`	URL	Obbligatorio: il `@id` della `TVSeason` di cui fa parte questa puntata.
`partOfSeason.seasonNumber`	Intero	Obbligatorio: il numero che indica la posizione di questa stagione nell'ordine delle stagioni della serie TV.
`partOfSeries`	TVSeries	Obbligatorio: la serie TV a cui appartiene la puntata.
`partOfSeries.@type`	Testo	Obbligatorio: impostato sempre su `TVSeries`.
`partOfSeries.@id`	URL	Obbligatorio: il `@id` del `TVSeries` di cui fa parte questa puntata.
`partOfSeries.name`	Testo	Obbligatorio: il nome della serie TV.
`partOfSeries.sameAs`	Testo	L'URL di una pagina web di riferimento che può identificare il programma, ad esempio la pagina di Wikipedia del programma. Deve essere diverso dalla proprietà `url`.
`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 Action 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 `TVEpisode` può essere disponibile sia su VoD che su Live TV. Utilizza un array per specificare link diretti diversi in più regioni. Consulta l'esempio Più regioni e lingue.
`sameAs`	Molto consigliato Perché? URL	L'URL di una pagina web di riferimento che può identificare la puntata, ad esempio la pagina di Wikipedia della puntata. Deve essere diverso dalla proprietà `url`.
`duration`	Durata	Tempo di esecuzione della puntata nel formato ISO 8601. Utilizza il formato: "PT00H00M".
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` o `ExclusiveEvent`	Molto consigliato Perché? - Un `PublicationEvent` viene utilizzato per specificare la data di uscita originale (globale o locale) dei contenuti da parte di un editore, ad esempio la data di uscita originale nelle sale cinematografiche 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 degli esempi per dettagli ed esempi.
`releasedEvent.@type`	Testo	Obbligatorio: assicurati di impostare sempre questa proprietà su una delle seguenti: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorio: le regioni associate a questo evento. Per un valore `PublicationEvent`, si tratta della regione in cui sono stati pubblicati i contenuti. 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 il valore `EARTH`.
`releasedEvent.startDate`	Data o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent`: la data di inizio della pubblicazione della persona giuridica. Per un `PublicationEvent`, indica la data di uscita iniziale della persona giuridica, ad esempio la data di prima uscita di un film nelle sale cinematografiche. Per `ExclusiveEvent` e `FeaturedEvent`, indica la data di inizio in cui la persona giuridica è in 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 sui contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il fornitore ha mostrato l'entità. Se i contenuti sono permanentemente esclusivi o in primo piano, 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	Molto consigliato Perché? Una sinossi della puntata. Sono preferibili le sinossi della trama rispetto ai riepiloghi fattuali. Limite di 300 caratteri. Utilizza un array per eseguire il markup della descrizione in più lingue. Consulta l'esempio di rappresentazione in più lingue.
`genre`	Testo	Un elenco ordinato di tutti i generi pertinenti. Ad esempio : `["Action", "Fashion", "Environment", "Football"]`
`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.
`actor`	Person o PerformingGroup o PerformanceRole	Molto consigliato Perché? Un array dei membri del cast della puntata. Consulta le indicazioni per la definizione del modello qui.
`director`	Person	Molto consigliato Perché? I registi della puntata.
`producer`	Organization o Person	Molto consigliato Perché? I produttori della stagione.
`image`	ImageObject	Molto consigliato Perché? per Google TV: varie immagini correlate alla puntata TV. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere con `image`, consulta Proprietà immagine.
`trailer.description`	Testo	La descrizione del trailer. Guarda l'esempio Trailer.
`trailer.inLanguage`	Testo	La lingua del trailer in 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 in formato ISO 3166.
`review`	Review	Rivedi le valutazioni dell'episodio TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito `review`. Viene utilizzato per specificare la valutazione data nella recensione.
`contentRating`	Testo o Valutazione	Obbligatorio per i contenuti per adulti, vivamente consigliato in caso contrario: classificazione dei contenuti complessiva. Se la classificazione dei contenuti è fornita sotto forma di stringa di testo, sono accettate due varianti: L'agenzia di rating ha anteposto la valutazione con uno spazio vuoto in mezzo. Ad esempio, una classificazione "TV-MA" dell'agenzia "TVPG" negli Stati Uniti deve essere descritta come "TVPG TV-MA". Consulta l'elenco delle agenzie. Un valore "RATING NOT KNOWN" (sensibile alle maiuscole) per indicare che non conosci la classificazione dei contenuti.
`contentRating.author`	Organizzazione	Obbligatorio se `contentRating` utilizza `Rating`: il nome dell'agenzia di classificazione. Consulta la pagina Agenzie di classificazione dei contenuti per un elenco delle agenzie di classificazione accettate
`contentRating.ratingValue`	Testo	Obbligatorio se `contentRating` utilizza `Rating`: il valore della classificazione.
`contentRating.advisoryCode`	Testo	Il codice di avviso per i contenuti. I valori accettati sono D, FV, L, S e V. D = Dialoghi, FV = Violenza fantastica, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza.
`identifier`	PropertyValue	Molto consigliato Perché? - ID esterno o un altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per maggiori dettagli, consulta la sezione Proprietà identificatore.
`popularityScore`	PopularityScoreSpecification	Molto consigliato Perché? Un 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 nei tuoi feed e tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
`popularityScore.@type`	Testo	Deve essere 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	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à a livello di località ha la precedenza sulla popolarità a livello globale (EARTH)

TVSeason

Proprietà	Tipo previsto	Descrizione
`@context`	Testo	Obbligatorio: impostato sempre su `["http://schema.org", {"@language": "xx"}]` dove"xx" rappresenta la lingua delle stringhe nel feed. Per ogni contesto dell'entità principale, l'attributo @language deve essere 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/doppiaggio è l'inglese.
`@type`	Testo	Obbligatorio: impostato sempre su `TVSeason`.
`@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 L'ID deve essere stabile e non cambiare nel tempo (anche se la proprietà url del programma cambia). Verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di URI (Uniform Resource Identifier) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché il `url` di un'entità soddisfa tutti i requisiti di un identificatore, ti consigliamo di utilizzare il `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 tuo feed a quelli dei database di Google. `url` deve soddisfare i seguenti requisiti: `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante che Google può eseguire la scansione. Per il link diretto per la riproduzione, consulta la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome della stagione TV. Utilizza un array per elencare i nomi in lingue diverse. Consulta l'esempio di rappresentazione in più lingue. Tieni presente che è supportato un solo nome per impostazioni internazionali (coppia lingua-paese).
`titleEIDR`	Testo	Molto consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, a livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, il valore titleEIDR per la prima stagione della serie TV nota come "Il trono di spade" è "10.5240/FD91-C72C-4161-FCBA-058B-1".
`seasonNumber`	Intero	Obbligatorio: il numero che indica la posizione di questa stagione nell'ordine delle stagioni della serie TV.
`partOfSeries`	TVSeries	Obbligatorio: la serie TV a cui appartiene questa stagione.
`partOfSeries.@type`	Testo	Obbligatorio: impostato sempre su `TVSeries`.
`partOfSeries.@id`	URL	Obbligatorio: il `@id` del `TVSeries` di cui fa parte questa stagione.
`partOfSeries.name`	Testo	Obbligatorio: il nome della serie TV.
`partOfSeries.sameAs`	Testo	L'URL di una pagina web di riferimento che può identificare il programma, ad esempio la pagina di Wikipedia del programma. Deve essere diverso dalla proprietà `url`.
`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 Action 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 `TVSeason` può essere disponibile sia su VoD che su Live TV. Utilizza un array per specificare link diretti diversi in più regioni. Consulta l'esempio Più regioni e lingue.
`sameAs`	URL	Molto consigliato Perché? L'URL di una pagina web di riferimento che può identificare la stagione, ad esempio la pagina di Wikipedia della stagione. Deve essere diverso dalla proprietà `url`.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` o `ExclusiveEvent`	Molto consigliato Perché? - Un `PublicationEvent` viene utilizzato per specificare la data di uscita originale (globale o locale) dei contenuti da parte di un editore, ad esempio la data di uscita originale nelle sale cinematografiche 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 degli esempi per dettagli ed esempi.
`releasedEvent.@type`	Testo	Obbligatorio: assicurati di impostare sempre questa proprietà su una delle seguenti: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorio: le regioni associate a questo evento. Per un valore `PublicationEvent`, si tratta della regione in cui sono stati pubblicati i contenuti. 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 il valore `EARTH`.
`releasedEvent.startDate`	Data o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent`: la data di inizio della pubblicazione della persona giuridica. Per un `PublicationEvent`, indica la data di uscita iniziale della persona giuridica, ad esempio la data di prima uscita di un film nelle sale cinematografiche. Per `ExclusiveEvent` e `FeaturedEvent`, indica la data di inizio in cui la persona giuridica è in 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 sui contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il fornitore ha mostrato l'entità. Se i contenuti sono permanentemente esclusivi o in primo piano, 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	Molto consigliato Perché? Una sinossi della stagione. Sono preferibili le sinossi della trama rispetto ai riepiloghi fattuali. Limite di 300 caratteri. Utilizza un array per eseguire il markup della descrizione in più lingue. Consulta l'esempio di rappresentazione in più lingue.
`actor`	[Person o PerformingGroup o PerformanceRole	Molto consigliato Perché? Un array dei membri del cast della stagione. Consulta le indicazioni per la definizione del modello qui.
`director`	Person	Molto consigliato Perché? Un array dei registi del programma.
`producer`	Organization o Person	Molto consigliato Perché? I produttori della stagione.
`image`	ImageObject	Le immagini correlate alla stagione TV. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere con `image`, consulta Proprietà immagine.
`genre`	Testo	Un elenco ordinato di tutti i generi pertinenti. Ad esempio : `["Action", "Fashion", "Environment", "Football"]`
`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.
`trailer.description`	Testo	La descrizione del trailer. Guarda l'esempio Trailer.
`trailer.inLanguage`	Testo	La lingua del trailer in 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 in formato ISO 3166.
`identifier`	PropertyValue	Molto consigliato Perché? - ID esterno o un altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per maggiori dettagli, consulta la sezione Proprietà identificatore.
`popularityScore`	PopularityScoreSpecification	Molto consigliato Perché? Un 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 nei tuoi feed e tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
`popularityScore.@type`	Testo	Deve essere 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	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 località ha la precedenza sulla popolarità globale (EARTH)
`review`	Review	Rivedi le valutazioni della stagione TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito `review`. Viene utilizzato per specificare la valutazione data nella recensione.
`contentRating`	Testo o Valutazione	Obbligatorio per i contenuti per adulti, vivamente consigliato in caso contrario: classificazione dei contenuti complessiva. Se la classificazione dei contenuti è fornita sotto forma di stringa di testo, sono accettate due varianti: L'agenzia di rating ha anteposto la valutazione con uno spazio vuoto in mezzo. Ad esempio, una classificazione "TV-MA" dell'agenzia "TVPG" negli Stati Uniti deve essere descritta come "TVPG TV-MA". Consulta l'elenco delle agenzie. Un valore "RATING NOT KNOWN" (sensibile alle maiuscole) per indicare che non conosci la classificazione dei contenuti.
`contentRating.author`	Organizzazione	Obbligatorio se `contentRating` utilizza `Rating`: il nome dell'agenzia di classificazione. Consulta la pagina Agenzie di classificazione dei contenuti per un elenco delle agenzie di classificazione accettate
`contentRating.ratingValue`	Testo	Obbligatorio se `contentRating` utilizza `Rating`: il valore della classificazione.
`contentRating.advisoryCode`	Testo	Il codice di avviso per i contenuti. I valori accettati sono D, FV, L, S e V. D = Dialoghi, FV = Violenza fantastica, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza.

Specifiche dell'attore

La proprietà actor nei tipi di entità TVSeries, TVEpisode e TVSeason consente di specificare ulteriori dettagli sugli attori, inclusi i nomi dei personaggi e i ruoli che interpretano nel programma TV. Le sezioni seguenti descrivono lo stesso concetto, con alcuni esempi che ne chiariscono l'utilizzo.

Proprietà Tipo previsto Descrizione

Proprietà	Tipo previsto	Descrizione
`actor`	Person o PerformingGroup o PerformanceRole	Molto consigliato Perché? : Un array dei membri del cast. Utilizza il tipo PerformanceRole quando sono noti il ruolo interpretato e (facoltativo) il nome del personaggio dei membri del cast. In questo caso, l'attore Person o PerformingGroup è incorporato nell'oggetto PerformanceRole. Utilizza il tipo Person per indicare gli attori individuali o PerformingGroup per fornire i dettagli dei gruppi/delle band che si esibiscono quando i ruoli interpretati dai membri del cast sono sconosciuti. Utilizza un array per rappresentare più persone, gruppi di artisti o ruoli di esecuzione.

actor

Person o PerformingGroup o PerformanceRole

Molto consigliato Perché? : Un array dei membri del cast.

Utilizza il tipo PerformanceRole quando sono noti il ruolo interpretato e (facoltativo) il nome del personaggio dei membri del cast. In questo caso, l'attore Person o PerformingGroup è incorporato nell'oggetto PerformanceRole.
Utilizza il tipo Person per indicare gli attori individuali o PerformingGroup per fornire i dettagli dei gruppi/delle band che si esibiscono quando i ruoli interpretati dai membri del cast sono sconosciuti.

Utilizza un array per rappresentare più persone, gruppi di artisti o ruoli di esecuzione.

Utilizzare i tipi `Person` o `PerformingGroup`

Fornisci le seguenti proprietà quando viene utilizzato il tipo Person o PerformingGroup

Proprietà	Tipo previsto	Descrizione
`@type`	Person o PerformingGroup	Obbligatorio: imposta sempre su Person o PerformingGroup
`@id`	URL	Molto consigliato Perché? - Gli attori o l'identificatore del gruppo che esegue in formato URI; ad esempio, https://example.com/actor/abc. `@id` deve soddisfare i seguenti requisiti: Univoco a livello globale nel tuo catalogo per attore/gruppo di artisti L'ID deve essere stabile e non cambiare nel tempo. Verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di URI (Uniform Resource Identifier) La tua organizzazione deve possedere il dominio utilizzato per il valore `@id`. Tieni presente che il valore `@id` utilizzato nella proprietà attore deve essere utilizzato in modo coerente in tutto il feed. Ad esempio, se ci sono due film con lo stesso attore, il valore `@id` deve essere mantenuto invariato in questi due oggetti attore.
`name`	Testo	Obbligatorio: il nome dell'attore/dell'attrice/del membro del cast/del gruppo che si esibisce.
`sameAs`	URL	Molto consigliato Perché? - Un URL a una pagina web di riferimento che possa identificare l'attore o il gruppo che esegue l'opera; ad esempio, la pagina di Wikipedia dell'attore. Deve essere diverso dalla proprietà `@id`.

Utilizzare il tipo `PerformanceRole`

Fornisci le seguenti proprietà quando viene utilizzato il tipo PerformanceRole

Proprietà	Tipo previsto	Descrizione
`@type`	PerformanceRole	Obbligatorio: impostato sempre su PerformanceRole
`roleName`	Testo	Molto consigliato Perché? - Un ruolo interpretato, eseguito o ricoperto dal membro del cast. Consulta l'elenco dei valori accettabili qui.
`characterName`	Testo	Il nome di un personaggio interpretato in un ruolo di attore o interprete. Non impostare questo campo se il tipo di attore è PerformingGroup.
`actor`	Person o PerformingGroup	Obbligatorio - I membri del cast dei contenuti quando viene utilizzato il tipo di dati Persona. I gruppi/le band che si esibiscono nei contenuti quando viene utilizzato il tipo di dati PerformingGroup.
`actor.@type`	Person o PerformingGroup	Obbligatorio: imposta sempre su Person o PerformingGroup
`actor.@id`	URL	Molto consigliato Perché? - L'identificatore dell'attore o del gruppo che esegue l'azione in formato URI; ad esempio, https://example.com/actor/abc. `@id` deve soddisfare i seguenti requisiti: Univoco a livello globale nel tuo catalogo per attore/gruppo di artisti L'ID deve essere stabile e non cambiare nel tempo. Verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di URI (Uniform Resource Identifier) La tua organizzazione deve possedere il dominio utilizzato per il valore `@id`. Tieni presente che il valore `@id` utilizzato nella proprietà attore deve essere utilizzato in modo coerente in tutto il feed. Ad esempio, se ci sono due film con lo stesso attore, il valore `@id` deve essere mantenuto invariato in questi due oggetti attore.
`actor.name`	Testo	Obbligatorio: il nome dell'attore/dell'attrice/del membro del cast/del gruppo che si esibisce.
`actor.sameAs`	URL	Molto consigliato Perché? - Un URL a una pagina web di riferimento che possa identificare l'attore o il gruppo che esegue l'opera; ad esempio, la pagina di Wikipedia dell'attore. Deve essere diverso dalla proprietà actor.@id.

Nomi dei ruoli accettabili

Questi valori richiedono che actor.@type sia Person.

Valore `roleName`	Descrizione
"Cameo"	Un cameo, chiamato anche apparizione cameo, è una breve apparizione di una persona famosa in un'opera delle arti dello spettacolo.
"VoiceActor"	Una performance vocale è quella in cui viene utilizzata la voce dell'attore, ma l'attore non appare sullo schermo. Questo problema si verifica più spesso nelle animazioni, ma anche quando la voce di un attore viene doppiata sopra quella di un altro attore.
"Doppia"	Un controfigura è una persona che sostituisce un altro attore in modo che il suo volto non venga mostrato.
"MotionCaptureActor"	Un MotionCaptureActor si riferisce a una persona che registra le azioni di attori umani e utilizza queste informazioni per animare modelli di personaggi digitali in animazione al computer 2D o 3D.

Questi valori sono generalmente accettati per i tipi Person e PerformingGroup.

Valore `roleName`	Descrizione
"Attore"	Un attore o un'attrice è una persona che interpreta un personaggio in uno spettacolo nel mezzo tradizionale del teatro o in media moderni come film, radio e televisione.
"GuestStar"	"Una guest star è un attore che interpreta un ruolo immaginario e appare in una o più puntate. In alcuni casi, una guest star può interpretare un personaggio ricorrente importante e apparire molte volte in una serie, pur non facendo parte del cast principale. Imposta il valore su "GuestStar" quando il cast ha un ospite o è un ospite del programma. Le guest star devono essere fornite solo a livello di puntata e non devono essere aggiunte a livello di TVSeries.
"Ospite"	"Un ospite in un talk show. Tieni presente che, mentre "GuestStar" è un ruolo immaginario, "Guest" è un'apparizione reale.
"Presentatore"	Un presentatore è una persona che pronuncia i discorsi di apertura e chiusura del programma, presenta il presentatore, i concorrenti e/o gli ospiti famosi, descrive i premi disponibili, scalda il pubblico prima delle registrazioni e lo intrattiene durante le interruzioni.
"Commentator"	Un commentatore fornisce un commento in tempo reale di una partita o di un evento, di solito durante una trasmissione in diretta.
"Impressionista"	Un imitatore è un artista il cui numero consiste nell'imitare suoni, voci e manierismi di celebrità e personaggi dei cartoni animati.
"Host"	Una persona che introduce, presenta o ospita programmi televisivi, spesso fungendo da mediatore tra il programma e il pubblico. Il ruolo "Presentatore" è generalmente un ruolo non di finzione.
"CoHost"	Una persona che organizza un evento/programma insieme ad altre persone.
"GuestHost"	Un presentatore ospite è un presentatore, di solito di un talk show, che conduce il programma al posto del presentatore regolare quando quest'ultimo non è disponibile.
"Conducente del telegiornale"	Una persona che presenta/informa il pubblico su notizie ed eventi che si verificano a livello locale, nazionale e internazionale tramite un programma di notizie della TV.
"Corrispondente"	Un corrispondente o un reporter sul posto è in genere un giornalista o un commentatore per una rivista oppure un agente che collabora con un giornale, un notiziario radio o televisivo o un altro tipo di azienda da una località remota, spesso distante.
"ShowJudge"	Un giudice è una persona spesso considerata esperta nel campo del programma a cui viene assegnato il ruolo di "giudice" per criticare i concorrenti che partecipano alle audizioni e alla competizione della serie TV.
"Componente del panel"	Un membro di un gruppo di discussione o consultivo di un programma radio o televisivo.
"Concorrente"	Un concorrente di un concorso o di un quiz è una persona che vi partecipa.
"StoryNarrator"	Narratore è una persona che racconta qualcosa, in particolare un personaggio che racconta gli eventi di un romanzo o di un poema narrativo
"MusicalArtist"	"Un artista musicale può essere una persona, un gruppo o un personaggio immaginario che in genere si è esibito regolarmente di fronte a un pubblico o ha registrato tracce musicali o album musicali. I compositori e i parolieri devono avere questo tipo di contributo solo se i riconoscimenti di un'opera musicale implicano che contribuiscono anche come interpreti principali. Questo tipo può essere utilizzato per associare musicisti o gruppi di musicisti permanenti e musicisti o gruppi di musicisti ospiti ai programmi.

Distinguere tra un ruolo principale e uno di supporto di un attore

Per distinguere tra gli attori principali/regolari e gli attori ospiti/di supporto in un programma TV, aggiungi il cast principale solo alle entità TVSeries e aggiungi solo il cast ospite o il cast con ruoli di supporto alle entità TVEpisode. Assicurati che il cast principale/regolare non venga aggiunto alle entità TVEpisode.

Esempi

Esempio di `TVSeries`, `TVEpisode` e `TVSeason`

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?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",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Esempi di proprietà `Actor`

Il ruolo dell'attore è sconosciuto

Quando il ruolo di un attore è sconosciuto, ti consigliamo di fornire solo le informazioni sull'attore utilizzando il tipo Person o PerformingGroup.

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

Il ruolo dell'attore è noto

Quando il ruolo di un attore è noto, ti consigliamo di fornire le informazioni sull'attore utilizzando il tipo PerformanceRole.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

Ruoli noti per un sottoinsieme di attori

Se i metadati del ruolo di esecuzione non sono noti, ti consigliamo di fornire le informazioni sull'attore utilizzando il tipo Persona o GruppoSpettacolo. Per l'altro caso in cui queste informazioni sono note, utilizza il tipo PerformanceRole. Questi tipi possono essere aggiunti insieme nello stesso array.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

Pagine correlate

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

Proprietà di markup dei contenuti di programmi TV

Tabella delle specifiche

TVSeries

TVEpisode

TVSeason

Specifiche dell'attore

Utilizzare i tipi Person o PerformingGroup

Utilizzare il tipo PerformanceRole

Nomi dei ruoli accettabili

Distinguere tra un ruolo principale e uno di supporto di un attore

Esempi

Esempio di TVSeries, TVEpisode e TVSeason

TVSeries

TVEpisode

TVSeason

Esempi di proprietà Actor

Il ruolo dell'attore è sconosciuto

Il ruolo dell'attore è noto

Ruoli noti per un sottoinsieme di attori

Pagine correlate

Utilizzare i tipi `Person` o `PerformingGroup`

Utilizzare il tipo `PerformanceRole`

Esempio di `TVSeries`, `TVEpisode` e `TVSeason`

Esempi di proprietà `Actor`