Proprietà di markup dei contenuti di programmi TV

Questa sezione fornisce i dettagli delle proprietà del 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: sempre impostato su `["http://schema.org", {"@language": "xx"}]` dove"xx" rappresenta la lingua delle stringhe nel feed. Il contesto di ogni entità principale deve avere @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 codificati/del doppiaggio è l'inglese.
`@type`	Testo	Obbligatorio: sempre impostato 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 corso del tempo (anche se la proprietà URL dello show cambia). Verrà trattato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di Uniform Resource Identifier (URI) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché l'`url` di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'`url` di un'entità come `@id`. Per ulteriori dettagli, consulta la sezione Identificatore.
`url`	URL	Obbligatorio: l'URL canonico dei contenuti, che Google utilizza per associare i contenuti del feed a quelli dei database di Google. `url` deve soddisfare i seguenti requisiti: `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante che Google possa scansionare. Per il deep link della 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. Vedi l'esempio Più regioni e lingue. Tieni presente che è supportato un solo nome per ogni lingua (coppia lingua-paese).
`titleEIDR`	Testo	Consigliato. Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, al livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, il titolo EIDR della serie TV "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 di markup Azione deve fornire il deep link dei contenuti. Se i contenuti sono disponibili su un canale Live TV, 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 diversi link diretti in più regioni. Vedi l'esempio Più regioni e lingue.
`sameAs`	URL	Consigliato. Perché? Un URL a 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	Consigliato: lingua originale della serie nel 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`	Consigliato. Perché? - Una `PublicationEvent` viene utilizzata per specificare la pubblicazione originale (globale o locale) dei contenuti da parte di un editore, ad esempio la data di uscita cinematografica originale di un film. Inoltre, utilizza `FeaturedEvent` per indicare che il tuo servizio commercializza questi contenuti come originali, in primo piano, speciali e così via. `ExclusiveEvent` specifica che il tuo servizio dispone dei diritti di distribuzione esclusivi e indica dove e quando. Per dettagli ed esempi, consulta la sezione Esempio.
`releasedEvent.@type`	Testo	Obbligatorio: assicurati di impostare sempre questa proprietà su uno dei seguenti valori: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorio: le regioni associate a questo evento. Per un `PublicationEvent`, questa è la regione in cui sono stati pubblicati i contenuti. Per `FeaturedEvent` e `ExclusiveEvent`, questa è la regione in cui i contenuti sono in evidenza o esclusivi. Utilizza i codici ISO 3166 per i paesi. Per indicare ovunque nel mondo, imposta `EARTH`.
`releasedEvent.startDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent` - La data di inizio della pubblicazione dell'entità. Per un `PublicationEvent`, indica la data di uscita iniziale dell'entità, ad esempio la data di uscita di un film nelle sale cinematografiche. Per `ExclusiveEvent` e `FeaturedEvent`, rappresenta la data di inizio del periodo di esclusiva o di messa in evidenza dell'entità.
`releasedEvent.endDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent` - Questo valore è applicabile solo ai tipi `ExclusiveEvent` e `FeaturedEvent`. Per `ExclusiveEvent`, rappresenta la data di scadenza dei diritti sui contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il fornitore mette in evidenza l'entità. Se i contenuti sono in esclusiva o in evidenza perpetua, imposta `endDate` su 20 anni dalla data attuale.
`releasedEvent.publishedBy`	Organization o Person	(Facoltativo): l'organizzazione o la persona che ha pubblicato questa entità.
`description`	Testo	Consigliato. Perché? Una sinossi del programma. Sono preferite le sinossi della trama ai riassunti fattuali. Limite di 300 caratteri. Utilizza un array per contrassegnare la descrizione in più lingue. Vedi l'esempio Più regioni e lingue.
`actor`	Person o PerformingGroup o PerformanceRole	Consigliato. Perché? Un array dei membri del cast della serie. Consulta le linee guida per la modellazione qui.
`director`	Person	Consigliato. Perché? Il regista o i registi del programma.
`producer`	Organization o Person	Consigliato. Perché? Il o i produttori del programma.
`image`	ImageObject	Obbligatorio per Google TV: le immagini relative alla serie TV. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere in `image`, consulta Proprietà immagine.
`trailer.description`	Testo	La descrizione del trailer. Vedi l'esempio di trailer.
`trailer.inLanguage`	Testo	Consigliato. La lingua del trailer nel formato BCP 47.
`trailer.url`	URL	Un URL di un trailer ospitato pubblicamente e caricato dai rispettivi studi di produzione o da fonti autorizzate.
`trailer.regionsAllowed`	Luogo	Le regioni in cui i contenuti multimediali sono consentiti. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi in formato ISO 3166.
`identifier`	PropertyValue	Consigliato. Perché? - ID esterno o altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per i dettagli, consulta la sezione Proprietà identificatore.
`popularityScore`	PopularityScoreSpecification	Consigliato. Perché? Un punteggio che Google utilizza, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo, pertanto la scala del punteggio deve essere coerente nei tuoi feed, tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
`popularityScore.@type`	Testo	Sempre impostato su `PopularityScoreSpecification`.
`popularityScore.value`	Number	Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto indica una maggiore popolarità.
`popularityScore.eligibleRegion`	Paese	La regione o le regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su `EARTH`. Per impostazione predefinita, questa proprietà è impostata su `EARTH`. `Note:` La popolarità specifica per la località ha la precedenza su quella globale (TERRA)
`review`	Review	Controllare le valutazioni della serie TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito `review`. Viene utilizzato per specificare la valutazione attribuita nella recensione.
`contentRating`	Text o Rating	Obbligatorio per i contenuti per adulti, altrimenti consigliato: classificazione generale dei contenuti. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti: L'agenzia di rating anteposta alla valutazione con uno spazio bianco tra le due. 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 di "RATING NOT KNOWN" (senza distinzione tra maiuscole e minuscole) 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 avvertenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogue, FV = Fantasy Violence , L = Language, S = Sexual Content, V = Violence.

TVEpisode

Proprietà	Tipo previsto	Descrizione
`@context`	Testo	Obbligatorio: sempre impostato su `["http://schema.org", {"@language": "xx"}]` dove"xx" rappresenta la lingua delle stringhe nel feed. Il contesto di ogni entità principale deve avere @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 codificati/del doppiaggio è l'inglese.
`@type`	Testo	Obbligatorio: sempre impostato 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 corso del tempo (anche se la proprietà URL dello show cambia). Verrà trattato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di Uniform Resource Identifier (URI) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché l'`url` di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'`url` di un'entità come `@id`. Per ulteriori dettagli, consulta la sezione Identificatore.
`url`	URL	Obbligatorio: l'URL canonico dei contenuti, che Google utilizza per associare i contenuti del feed a quelli dei database di Google. `url` deve soddisfare i seguenti requisiti: `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante che Google possa scansionare. Per il deep link 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. Vedi l'esempio di rappresentazione in più lingue. Tieni presente che è supportato un solo nome per ogni lingua (coppia lingua-paese).
`titleEIDR`	Testo	Consigliato. Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, al livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, il titoloEIDR del primo episodio della prima stagione della serie TV nota come "Il Trono di Spade" è "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
`editEIDR`	Testo	Consigliato. Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta una modifica / edizione specifica di un'opera cinematografica o televisiva. Ad esempio, il primo episodio della prima stagione della serie TV nota come "Il Trono di Spade", il cui EIDR del titolo è "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", ha una modifica, ad esempio "10.5240/FB97-C847-2969-D0AB-ECD1-C". La proprietà `titleEIDR` è obbligatoria quando viene fornito editEIDR.
`inLanguage`	Testo	Altamente consigliato: lingua originale dell'episodio nel formato BCP 47.
`episodeNumber`	Intero	Obbligatorio: il numero che indica la posizione di questo episodio nell'ordine degli episodi di una stagione. `episodeNumber` deve ripartire da 1 per ogni stagione, ovvero il primo episodio di ogni stagione deve essere 1.
`partOfSeason`	TVSeason	Obbligatorio: la stagione TV a cui appartiene questa 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 esempio, http://www.example.com/my_favorite_tv_show) e aggiungi un campo di query segnaposto (ad esempio, ?season1) per creare un `partOfSeason.@id` univoco (ad esempio, http://www.example.com/my_favorite_tv_show?season1). Imposta `partOfSeason.seasonNumber` su 1.
`partOfSeason.@type`	Testo	Obbligatorio: sempre impostato su `TVSeason`.
`partOfSeason.@id`	URL	Obbligatorio: il `@id` del `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 questa puntata.
`partOfSeries.@type`	Testo	Obbligatorio: sempre impostato 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	Un URL a 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 di markup Azione deve fornire il deep link dei contenuti. Se i contenuti sono disponibili su un canale Live TV, 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 diversi link diretti in più regioni. Vedi l'esempio Più regioni e lingue.
`sameAs`	Consigliato. Perché? URL	Un URL a una pagina web di riferimento che può identificare l'episodio, ad esempio la pagina di Wikipedia dell'episodio. Deve essere diverso dalla proprietà `url`.
`duration`	Durata	La durata dell'episodio in formato ISO 8601. Utilizza il formato "PT00H00M".
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` o `ExclusiveEvent`	Consigliato. Perché? - Una `PublicationEvent` viene utilizzata per specificare la pubblicazione originale (globale o locale) dei contenuti da parte di un editore, ad esempio la data di uscita cinematografica originale di un film. Inoltre, utilizza `FeaturedEvent` per indicare che il tuo servizio commercializza questi contenuti come originali, in primo piano, speciali e così via. `ExclusiveEvent` specifica che il tuo servizio dispone dei diritti di distribuzione esclusivi e indica dove e quando. Per dettagli ed esempi, consulta la sezione Esempio.
`releasedEvent.@type`	Testo	Obbligatorio: assicurati di impostare sempre questa proprietà su uno dei seguenti valori: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorio: le regioni associate a questo evento. Per un `PublicationEvent`, questa è la regione in cui sono stati pubblicati i contenuti. Per `FeaturedEvent` e `ExclusiveEvent`, questa è la regione in cui i contenuti sono in evidenza o esclusivi. Utilizza i codici ISO 3166 per i paesi. Per indicare ovunque nel mondo, imposta `EARTH`.
`releasedEvent.startDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent` - La data di inizio della pubblicazione dell'entità. Per un `PublicationEvent`, indica la data di uscita iniziale dell'entità, ad esempio la data di uscita di un film nelle sale cinematografiche. Per `ExclusiveEvent` e `FeaturedEvent`, rappresenta la data di inizio del periodo di esclusiva o di messa in evidenza dell'entità.
`releasedEvent.endDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent` - Questo valore è applicabile solo ai tipi `ExclusiveEvent` e `FeaturedEvent`. Per `ExclusiveEvent`, rappresenta la data di scadenza dei diritti sui contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il fornitore mette in evidenza l'entità. Se i contenuti sono in esclusiva o in evidenza perpetua, imposta `endDate` su 20 anni dalla data attuale.
`releasedEvent.publishedBy`	Organization o Person	(Facoltativo): l'organizzazione o la persona che ha pubblicato questa entità.
`description`	Testo	Consigliato. Perché? Una sinossi della puntata. Sono preferite le sinossi della trama ai riassunti fattuali. Limite di 300 caratteri. Utilizza un array per contrassegnare la descrizione in più lingue. Vedi 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	Consigliato. Perché? Un array dei membri del cast della puntata. Consulta le linee guida per la modellazione qui.
`director`	Person	Consigliato. Perché? Il regista o i registi dell'episodio.
`producer`	Organization o Person	Consigliato. Perché? Il o i produttori della stagione.
`image`	ImageObject	Consigliato: perché? per Google TV: varie immagini correlate all'episodio TV. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere in `image`, consulta Proprietà immagine.
`trailer.description`	Testo	La descrizione del trailer. Vedi l'esempio di trailer.
`trailer.inLanguage`	Testo	Consigliato. La lingua del trailer nel formato BCP 47.
`trailer.url`	URL	Un URL di un trailer ospitato pubblicamente e caricato dai rispettivi studi di produzione o da fonti autorizzate.
`trailer.regionsAllowed`	Luogo	Le regioni in cui i contenuti multimediali sono consentiti. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi in formato ISO 3166.
`review`	Review	Rivedere le valutazioni dell'episodio TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito `review`. Viene utilizzato per specificare la valutazione attribuita nella recensione.
`contentRating`	Text o Rating	Obbligatorio per i contenuti per adulti, altrimenti consigliato: classificazione generale dei contenuti. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti: L'agenzia di rating anteposta alla valutazione con uno spazio bianco tra le due. 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 di "RATING NOT KNOWN" (senza distinzione tra maiuscole e minuscole) 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 avvertenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogue, FV = Fantasy Violence , L = Language, S = Sexual Content, V = Violence.
`identifier`	PropertyValue	Consigliato. Perché? - ID esterno o altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per i dettagli, consulta la sezione Proprietà identificatore.
`popularityScore`	PopularityScoreSpecification	Consigliato. Perché? Un punteggio che Google utilizza, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo, pertanto la scala del punteggio deve essere coerente nei tuoi feed, tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
`popularityScore.@type`	Testo	Sempre impostato su `PopularityScoreSpecification`.
`popularityScore.value`	Number	Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto indica una maggiore popolarità.
`popularityScore.eligibleRegion`	Paese	La regione o le regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su `EARTH`. Per impostazione predefinita, questa proprietà è impostata su `EARTH`. `Note:` La popolarità specifica per la località ha la precedenza su quella globale (TERRA)

TVSeason

Proprietà	Tipo previsto	Descrizione
`@context`	Testo	Obbligatorio: sempre impostato su `["http://schema.org", {"@language": "xx"}]` dove"xx" rappresenta la lingua delle stringhe nel feed. Il contesto di ogni entità principale deve avere @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 codificati/del doppiaggio è l'inglese.
`@type`	Testo	Obbligatorio: sempre impostato 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 corso del tempo (anche se la proprietà URL dello show cambia). Verrà trattato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di Uniform Resource Identifier (URI) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché l'`url` di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'`url` di un'entità come `@id`. Per ulteriori dettagli, consulta la sezione Identificatore.
`url`	URL	Obbligatorio: l'URL canonico dei contenuti, che Google utilizza per associare i contenuti del feed a quelli dei database di Google. `url` deve soddisfare i seguenti requisiti: `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante che Google possa scansionare. Per il deep link della riproduzione, consulta la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome di questa stagione TV. Utilizza un array per elencare i nomi in lingue diverse. Vedi l'esempio di rappresentazione in più lingue. Tieni presente che è supportato un solo nome per ogni lingua (coppia lingua-paese).
`titleEIDR`	Testo	Consigliato. Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, al livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, l'EIDR del titolo della 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: sempre impostato su `TVSeries`.
`partOfSeries.@id`	URL	Obbligatorio: il `@id` della `TVSeries` di cui fa parte questa stagione.
`partOfSeries.name`	Testo	Obbligatorio: il nome della serie TV.
`partOfSeries.sameAs`	Testo	Un URL a 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 di markup Azione deve fornire il deep link dei contenuti. Se i contenuti sono disponibili su un canale Live TV, 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 diversi link diretti in più regioni. Vedi l'esempio Più regioni e lingue.
`sameAs`	URL	Consigliato. Perché? Un 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`	Consigliato. Perché? - Una `PublicationEvent` viene utilizzata per specificare la pubblicazione originale (globale o locale) dei contenuti da parte di un editore, ad esempio la data di uscita cinematografica originale di un film. Inoltre, utilizza `FeaturedEvent` per indicare che il tuo servizio commercializza questi contenuti come originali, in primo piano, speciali e così via. `ExclusiveEvent` specifica che il tuo servizio dispone dei diritti di distribuzione esclusivi e include dove e quando. Per dettagli ed esempi, consulta la sezione Esempio.
`releasedEvent.@type`	Testo	Obbligatorio: assicurati di impostare sempre questa proprietà su uno dei seguenti valori: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorio: le regioni associate a questo evento. Per un `PublicationEvent`, questa è la regione in cui sono stati pubblicati i contenuti. Per `FeaturedEvent` e `ExclusiveEvent`, questa è la regione in cui i contenuti sono in evidenza o esclusivi. Utilizza i codici ISO 3166 per i paesi. Per indicare ovunque nel mondo, imposta `EARTH`.
`releasedEvent.startDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent` - La data di inizio della pubblicazione dell'entità. Per un `PublicationEvent`, indica la data di uscita iniziale dell'entità, ad esempio la data di uscita di un film nelle sale cinematografiche. Per `ExclusiveEvent` e `FeaturedEvent`, rappresenta la data di inizio del periodo di esclusiva o di messa in evidenza dell'entità.
`releasedEvent.endDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent` - Questo valore è applicabile solo ai tipi `ExclusiveEvent` e `FeaturedEvent`. Per `ExclusiveEvent`, rappresenta la data di scadenza dei diritti sui contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il fornitore mette in evidenza l'entità. Se i contenuti sono in esclusiva o in evidenza perpetua, imposta `endDate` su 20 anni dalla data attuale.
`releasedEvent.publishedBy`	Organization o Person	(Facoltativo): l'organizzazione o la persona che ha pubblicato questa entità.
`description`	Testo	Consigliato. Perché? Una sinossi della stagione. Sono preferite le sinossi della trama ai riassunti fattuali. Limite di 300 caratteri. Utilizza un array per contrassegnare la descrizione in più lingue. Vedi l'esempio di rappresentazione in più lingue.
`actor`	[Person o PerformingGroup o PerformanceRole	Consigliato. Perché? Un array dei membri del cast della stagione. Consulta le linee guida per la modellazione qui.
`director`	Person	Consigliato. Perché? Un array dei registi dello spettacolo.
`producer`	Organization o Person	Consigliato. Perché? Il o i produttori della stagione.
`image`	ImageObject	Le immagini correlate alla stagione della serie TV. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere in `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. Vedi l'esempio di trailer.
`trailer.inLanguage`	Testo	Consigliato. La lingua del trailer nel formato BCP 47.
`trailer.url`	URL	Un URL di un trailer ospitato pubblicamente e caricato dai rispettivi studi di produzione o da fonti autorizzate.
`trailer.regionsAllowed`	Luogo	Le regioni in cui i contenuti multimediali sono consentiti. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi in formato ISO 3166.
`identifier`	PropertyValue	Consigliato. Perché? - ID esterno o altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per i dettagli, consulta la sezione Proprietà identificatore.
`popularityScore`	PopularityScoreSpecification	Consigliato. Perché? Un punteggio che Google utilizza, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo, pertanto la scala del punteggio deve essere coerente nei tuoi feed, tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
`popularityScore.@type`	Testo	Sempre impostato su `PopularityScoreSpecification`.
`popularityScore.value`	Number	Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto indica una maggiore popolarità.
`popularityScore.eligibleRegion`	Paese	La regione o le regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su `EARTH`. Per impostazione predefinita, questa proprietà è impostata su `EARTH`. `Note:` La popolarità specifica per la località ha la precedenza su quella globale (TERRA)
`review`	Review	Controllare le valutazioni della stagione TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito `review`. Viene utilizzato per specificare la valutazione attribuita nella recensione.
`contentRating`	Text o Rating	Obbligatorio per i contenuti per adulti, altrimenti consigliato: classificazione generale dei contenuti. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti: L'agenzia di rating anteposta alla valutazione con uno spazio bianco tra le due. 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 di "RATING NOT KNOWN" (senza distinzione tra maiuscole e minuscole) 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 avvertenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogue, FV = Fantasy Violence , L = Language, S = Sexual Content, V = Violence.

Specifiche dell'attore

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

Proprietà Tipo previsto Descrizione

Proprietà	Tipo previsto	Descrizione
`actor`	Person o PerformingGroup o PerformanceRole	Consigliato. Perché? : Un array dei membri del cast. Utilizza il tipo PerformanceRole quando è noto il ruolo interpretato e (facoltativamente) il nome del personaggio o dei personaggi del cast. In questo caso, l'attore Person o PerformingGroup è incorporato nell'oggetto PerformanceRole. Utilizza il tipo Person per indicare l'attore o gli attori individuali oppure PerformingGroup per fornire i dettagli del gruppo o dei gruppi musicali quando il ruolo o i ruoli interpretati dai membri del cast non sono noti. Utilizza un array per rappresentare più persone, gruppi musicali o ruoli di esecuzione.

actor

Person o PerformingGroup o PerformanceRole

Consigliato. Perché? : Un array dei membri del cast.

Utilizza il tipo PerformanceRole quando è noto il ruolo interpretato e (facoltativamente) il nome del personaggio o dei personaggi del cast. In questo caso, l'attore Person o PerformingGroup è incorporato nell'oggetto PerformanceRole.
Utilizza il tipo Person per indicare l'attore o gli attori individuali oppure PerformingGroup per fornire i dettagli del gruppo o dei gruppi musicali quando il ruolo o i ruoli interpretati dai membri del cast non sono noti.

Utilizza un array per rappresentare più persone, gruppi musicali 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: sempre impostato su Person o PerformingGroup
`@id`	URL	Consigliato. Perché? - L'identificatore dell'attore o del gruppo di esecuzione 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 musicale L'ID deve essere stabile e non cambiare nel corso del tempo. Verrà trattato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di Uniform Resource Identifier (URI) La tua organizzazione deve essere proprietaria del dominio utilizzato per il valore `@id`. Tieni presente che il valore `@id` utilizzato nella proprietà actor deve essere utilizzato in modo coerente in tutto il feed. Ad esempio, se ci sono due film con lo stesso attore, il valore di `@id` deve rimanere lo stesso in questi due oggetti attore.
`name`	Testo	Obbligatorio: il nome dell'attore, dell'attrice, del membro del cast o del gruppo musicale.
`sameAs`	URL	Consigliato. Perché? - Un URL a una pagina web di riferimento che può identificare l'attore o il gruppo musicale; 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: sempre impostato su PerformanceRole
`roleName`	Testo	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 recitazione o esibizione. Non impostare questo campo se il tipo di attore è PerformingGroup.
`actor`	Person o PerformingGroup	Obbligatorio - Il cast dei contenuti quando viene utilizzato il tipo di dati Persona. Il gruppo o i gruppi/la band o le band che eseguono i contenuti quando viene utilizzato il tipo di dati PerformingGroup.
`actor.@type`	Person o PerformingGroup	Obbligatorio: impostato sempre su Person o PerformingGroup
`actor.@id`	URL	Consigliato. Perché? - L'identificatore dell'attore o del gruppo di esecuzione 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 musicale L'ID deve essere stabile e non cambiare nel corso del tempo. Verrà trattato come una stringa opaca e non deve necessariamente essere un link funzionante. Sotto forma di Uniform Resource Identifier (URI) La tua organizzazione deve essere proprietaria del dominio utilizzato per il valore `@id`. Tieni presente che il valore `@id` utilizzato nella proprietà actor deve essere utilizzato in modo coerente in tutto il feed. Ad esempio, se ci sono due film con lo stesso attore, il valore di `@id` deve rimanere lo stesso in questi due oggetti attore.
`actor.name`	Testo	Obbligatorio: il nome dell'attore, dell'attrice, del membro del cast o del gruppo musicale.
`actor.sameAs`	URL	Consigliato. Perché? - Un URL a una pagina web di riferimento che può identificare l'attore o il gruppo musicale; 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 è una breve apparizione di una persona nota in un'opera di arti dello spettacolo.
"VoiceActor"	Una performance vocale è una performance in cui viene utilizzata la voce dell'attore, ma l'attore non appare sullo schermo. Questo tipo di problema si verifica più spesso nei film d'animazione, ma anche quando la voce di un attore viene doppiata sopra il discorso di un altro attore.
"Double" (doppio)	Una 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 computerizzata 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 una rappresentazione nel mezzo tradizionale del teatro o nei media moderni come cinema, radio e televisione.
"GuestStar"	"Una guest star è un attore che interpreta un ruolo fittizio e appare in una o poche puntate. In alcuni casi, una guest star può interpretare un personaggio ricorrente importante e può apparire molte volte in una serie, pur non facendo parte del cast principale. Imposta il valore su "GuestStar" quando il cast ha una partecipazione speciale o è un ospite dello spettacolo. Le guest star devono essere fornite solo a livello di episodio e non devono essere aggiunte a livello di serie TV.
"Ospite"	"Un ospite di un talk show. Tieni presente che, mentre "GuestStar" è un ruolo fittizio, "Guest" è un'apparizione non fittizia.
"Annunciatore"	Un annunciatore è una persona che pronuncia le frasi di apertura e chiusura dello spettacolo, introduce il conduttore, i concorrenti e/o gli ospiti famosi, descrive i premi disponibili, intrattiene il pubblico prima della registrazione e durante le pause.
"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 che imita suoni, voci e modi di fare di celebrità e personaggi dei cartoni animati.
"Host"	Una persona che introduce, presenta o conduce programmi televisivi, spesso fungendo da mediatore tra il programma e il pubblico. Il ruolo "Host" è generalmente un ruolo non di finzione.
"CoHost"	Una persona che ospita un evento/programma insieme a un'altra persona o altre persone.
"GuestHost"	Un conduttore ospite è un conduttore, di solito di un talk show, che conduce il programma al posto del conduttore regolare quando non è disponibile.
"Newscaster"	Una persona che presenta/informa il pubblico su notizie ed eventi che si verificano a livello locale, nazionale e internazionale attraverso un programma di notizie televisivo.
"Corrispondente"	Un corrispondente o un reporter sul posto è in genere un giornalista o un commentatore di una rivista oppure un agente che contribuisce con report a un giornale, a notiziari radiofonici o televisivi o a un altro tipo di società, da una località remota, spesso distante.
"ShowJudge"	Un giudice è una persona spesso considerata un esperto nel campo dello spettacolo e a cui viene assegnato il ruolo di "giudice" per valutare i concorrenti che partecipano alle audizioni e alla competizione della serie TV.
"Panelist"	Membro di un gruppo di discussione o consultivo di un panel radiofonico o televisivo.
"Concorrente"	Un concorrente di una competizione o di un quiz è una persona che vi partecipa.
"StoryNarrator"	Il narratore è una persona che narra 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 di fantasia che si è esibito regolarmente davanti a un pubblico o ha registrato tracce o album musicali. I compositori e gli autori dei testi devono avere questo tipo solo se i crediti di un'opera musicale implicano che contribuiscono anche come esecutori principali. Questo tipo può essere utilizzato per associare musicisti o gruppi musicali permanenti e musicisti o gruppi musicali ospiti agli spettacoli.

Distinguere tra il ruolo principale e quello secondario di un attore

Per distinguere tra gli attori principali/regolari e gli attori ospiti/secondari di un programma TV, aggiungi il cast principale solo alle entità TVSeries e aggiungi solo il cast ospite o con ruoli secondari alle entità TVEpisode. Assicurati che il cast principale/regolare non sia 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

Quando i metadati del ruolo di esecuzione non sono noti, ti consigliamo di fornire le informazioni sull'attore utilizzando il tipo Person o PerformingGroup. 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 correlati a queste proprietà:

Proprietà di markup dei contenuti di programmi TV Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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 il ruolo principale e quello secondario 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

Proprietà di markup dei contenuti di programmi TV

Utilizzare i tipi `Person` o `PerformingGroup`

Utilizzare il tipo `PerformanceRole`

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

Esempi di proprietà `Actor`