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.

La specifica di TVSeason come entità completa è facoltativa. Per informazioni dettagliate, consulta la sezione Relazioni TVSeries, TVSeason e TVEpisode.

Tabella delle specifiche

TVSeries

Proprietà	Tipo previsto	Descrizione
`@context`	Testo	Obbligatorio - Imposta sempre su `["http://schema.org", {"@language": "xx"}]` Dove" xx" rappresenta la lingua delle stringhe nel feed. In ogni contesto di entità principale deve essere impostato il codice @language sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, si presume che i nomi siano in spagnolo anche se la lingua dei sottotitoli e del doppiaggio è in inglese.
`@type`	Testo	Obbligatorio - Imposta sempre su `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 podcast cambia). Verrà trattata come una stringa opaca e non deve essere necessariamente un link funzionante. Sotto forma di URI (Unified Resource Identifier) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché il valore `url` di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare il valore `url` di un'entità come `@id`. Per ulteriori dettagli, consulta la sezione Identificatore.
`url`	URL	Obbligatorio: l'URL canonico dei contenuti, che Google utilizza per abbinare i contenuti del tuo feed ai contenuti nei database di Google. `url` deve soddisfare i seguenti requisiti: `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante di cui Google possa eseguire la scansione. Per il link diretto della riproduzione, vedi invece la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome del 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 lingua (coppia lingua-paese).
`titleEIDR`	Testo	Altamente consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, a livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, titleEIDR per 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 dell'azione deve fornire il link diretto dei contenuti. Se i contenuti sono disponibili su un canale LiveTV, questa proprietà è facoltativa. l'entità `BroadcastService` associata fornisce invece il link diretto del canale. Un `TVSeries` può essere disponibile sia su VOD e LiveTV. Utilizza un array per specificare link diretti diversi in più regioni. Vedi l'esempio Più regioni e lingue.
`sameAs`	URL	Altamente consigliato Perché? Un URL a una pagina web di riferimento in grado di identificare il programma. ad esempio la pagina Wikipedia del programma. Deve essere diverso dalla proprietà `url`.
`inLanguage`	Testo	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, ["caratteristica, biografia"] può essere un insieme di parole chiave per descrivere i contenuti.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` o `ExclusiveEvent`	Altamente consigliato Perché? - Viene utilizzato un `PublicationEvent` per specificare la pubblicazione originale (globale o locale) dei contenuti di un editore, ad esempio la data di uscita nei cinema originali di un film. Inoltre, utilizza `FeaturedEvent` per indicare che il tuo servizio commercializza questi contenuti come originali, in primo piano, speciali e così via. `ExclusiveEvent` specifica che il tuo servizio ha diritti di distribuzione esclusivi e specifica dove e quando. Consulta la sezione degli esempi per dettagli ed esempi.
`releasedEvent.@type`	Testo	Obbligatorio - Assicurati di impostare sempre questa proprietà su uno dei seguenti valori: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorie: le regioni associate a questo evento. Per `PublicationEvent`, questa è la regione in cui sono stati pubblicati i contenuti. Per `FeaturedEvent` e `ExclusiveEvent`, questa è la regione in cui i contenuti vengono messi in primo piano o in esclusiva. Utilizza i codici ISO 3166 per i paesi. Per indicarlo ovunque nel mondo, imposta `EARTH`.
`releasedEvent.startDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent`: la data di inizio della pubblicazione dell'entità. Per `PublicationEvent`, indica la data di uscita iniziale dell'entità, ad esempio la data in cui il film è stato pubblicato per la prima volta nei cinema. Per `ExclusiveEvent` e `FeaturedEvent`, rappresenta la data di inizio in cui l'entità diventa esclusiva o viene messa in primo piano.
`releasedEvent.endDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent`: applicabile solo ai tipi `ExclusiveEvent` e `FeaturedEvent`. Per `ExclusiveEvent`, rappresenta la data di scadenza dei diritti relativi ai contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il fornitore mette in primo piano l'entità. Se i contenuti sono in primo piano o esclusivi per sempre, imposta `endDate` su 20 anni dalla data corrente.
`releasedEvent.publishedBy`	Organization o Person	Facoltativo - L'organizzazione o la persona che ha pubblicato questa entità.
`description`	Testo	Altamente consigliato Perché? Un riassunto della serie. È preferibile optare per le sinossi dei lotti piuttosto che per i riepiloghi oggettivi. Limite di 300 caratteri. Utilizza un array per eseguire il markup della descrizione in più lingue. Vedi l'esempio Più regioni e lingue.
`actor`	Person, PerformingGroup o PerformanceRole	Altamente consigliato Perché? Un array dei membri del cast della serie. Consulta le indicazioni sulla modellazione qui.
`director`	Person	Altamente consigliato Perché? I registi del programma.
`producer`	Organization o Person	Altamente consigliato Perché? I produttori del programma.
`image`	ImageObject	Obbligatorio per Google TV: le immagini relative a TVSeries. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere in `image`, consulta la sezione Proprietà delle immagini.
`trailer.description`	Testo	La descrizione del trailer. Vedi l'esempio del Trailer.
`trailer.inLanguage`	Testo	La lingua del trailer nel formato BCP 47.
`trailer.url`	URL	L'URL di un trailer ospitato pubblicamente e caricato dai rispettivi studi di produzione o da fonti autorizzate.
`trailer.regionsAllowed`	Luogo	Le regioni in cui i contenuti multimediali sono consentiti. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi nel formato ISO 3166.
`identifier`	PropertyValue	Altamente consigliato Perché? - ID esterno o di altro tipo che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per informazioni dettagliate, consulta la sezione Proprietà dell'identificatore.
`popularityScore`	PopularityScoreSpecification	Altamente consigliato Perché? Punteggio utilizzato da Google, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo. pertanto la scala del punteggio deve essere coerente in tutti i feed, tra tutte le entità nel catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
`popularityScore.@type`	Testo	Imposta sempre su `PopularityScoreSpecification`.
`popularityScore.value`	Number	Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto corrisponde a una maggiore popolarità.
`popularityScore.eligibleRegion`	Paese	Regioni in cui è applicabile il punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su `EARTH`. Per impostazione predefinita, questa proprietà è impostata su `EARTH`. `Note:` La popolarità specifica per località ha la precedenza sulla popolarità globale (EARTH)
`review`	Review	Esamina le classificazioni della serie TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito il valore `review`. Viene utilizzato per specificare la valutazione fornita nella recensione.
`contentRating`	Testo o Valutazione	Obbligatorio per i contenuti per adulti, vivamente consigliato altrimenti: classificazione complessiva dei contenuti. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti: L'agenzia di classificazione è stata preceduta da uno spazio vuoto. Ad esempio, "TV-MA" valutazione dall'agenzia "TVPG" negli Stati Uniti deve essere descritta come "TVPG TV-MA". Consulta l'elenco delle agenzie. Il valore "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 valutazione.
`contentRating.advisoryCode`	Testo	Il codice di consulenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogo, FV = Violenza di fantasia, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza.

TVEpisode

Proprietà	Tipo previsto	Descrizione
`@context`	Testo	Obbligatorio - Imposta sempre su `["http://schema.org", {"@language": "xx"}]` Dove" xx" rappresenta la lingua delle stringhe nel feed. In ogni contesto di entità principale deve essere impostato il codice @language sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, si presume che i nomi siano in spagnolo anche se la lingua dei sottotitoli e del doppiaggio è in inglese.
`@type`	Testo	Obbligatorio - Imposta sempre su `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 podcast cambia). Verrà trattata come una stringa opaca e non deve essere necessariamente un link funzionante. Sotto forma di URI (Unified Resource Identifier) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché il valore `url` di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare il valore `url` di un'entità come `@id`. Per ulteriori dettagli, consulta la sezione Identificatore.
`url`	URL	Obbligatorio: l'URL canonico dei contenuti, che Google utilizza per abbinare i contenuti del tuo feed ai contenuti nei database di Google. `url` deve soddisfare i seguenti requisiti: `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante di cui Google possa eseguire la scansione. Per il link diretto della riproduzione, vedi invece la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome della puntata. Utilizza un array per elencare i nomi in lingue diverse. Vedi l'esempio della rappresentazione in più lingue. Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
`titleEIDR`	Testo	Altamente consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, a livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, titleEIDR, per il primo episodio della prima stagione di TVSeries chiamata "Il Trono di Spade" è "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
`editEIDR`	Testo	Altamente consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta un montaggio / un'edizione specifica di un film o un programma televisivo. Ad esempio, il primo episodio della prima stagione di TVSeries detta "Il Trono di Spade", il cui titolo EIDR è "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", ha un solo montaggio, ad es. "10.5240/FB97-C847-2969-D0AB-ECD1-C". La proprietà `titleEIDR` è obbligatoria quando viene fornito un Modifica EIDR.
`inLanguage`	Testo	Lingua originale della serie nel formato BCP 47.
`episodeNumber`	Intero	Obbligatorio: il numero che indica la posizione dell'episodio nell'ordine delle puntate di una stagione. `episodeNumber` devono riavviare per ogni stagione. cioè il primo episodio di ogni stagione deve essere il primo.
`partOfSeason`	TVSeason	Obbligatorio: la stagione TV a cui appartiene questa puntata. Anche se un `TVEpisode` non ha un valore `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 allega un campo di query segnaposto (ad esempio, http://www.example.com/my_favorite_tv_show) per creare un `partOfSeason.@id` univoco (ad esempio, http://www.example.com/my_favorite_tv_show). Imposta `partOfSeason.seasonNumber` su 1.
`partOfSeason.@type`	Testo	Obbligatorio - Imposta sempre su `TVSeason`.
`partOfSeason.@id`	URL	Obbligatorio. Il `@id` di `TVSeason` di cui fa parte questa puntata.
`partOfSeason.seasonNumber`	Intero	Obbligatorio: il numero che indica la posizione della stagione in questione nell'ordine delle stagioni della serie TV.
`partOfSeries`	TVSeries	Obbligatorio: la serie TV a cui appartiene l'episodio.
`partOfSeries.@type`	Testo	Obbligatorio - Imposta sempre su `TVSeries`.
`partOfSeries.@id`	URL	Obbligatorio. Il `@id` di `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 in grado di identificare il programma. ad esempio la pagina 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 dell'azione deve fornire il link diretto dei contenuti. Se i contenuti sono disponibili su un canale LiveTV, questa proprietà è facoltativa. l'entità `BroadcastService` associata fornisce invece il link diretto del canale. Un `TVEpisode` può essere disponibile sia su VOD e LiveTV. Utilizza un array per specificare link diretti diversi in più regioni. Vedi l'esempio Più regioni e lingue.
`sameAs`	Altamente consigliato Perché? URL	L'URL di una pagina web di riferimento in grado di identificare la puntata. ad es. la pagina Wikipedia dell'episodio. Deve essere diverso dalla proprietà `url`.
`duration`	Durata	Tempo di esecuzione della puntata in formato ISO 8601. Utilizza il formato: "PT00H00M".
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` o `ExclusiveEvent`	Altamente consigliato Perché? - Viene utilizzato un `PublicationEvent` per specificare la pubblicazione originale (globale o locale) dei contenuti di un editore, ad esempio la data di uscita nei cinema originali di un film. Inoltre, utilizza `FeaturedEvent` per indicare che il tuo servizio commercializza questi contenuti come originali, in primo piano, speciali e così via. `ExclusiveEvent` specifica che il tuo servizio ha diritti di distribuzione esclusivi e specifica dove e quando. Consulta la sezione degli esempi per dettagli ed esempi.
`releasedEvent.@type`	Testo	Obbligatorio - Assicurati di impostare sempre questa proprietà su uno dei seguenti valori: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorie: le regioni associate a questo evento. Per `PublicationEvent`, questa è la regione in cui sono stati pubblicati i contenuti. Per `FeaturedEvent` e `ExclusiveEvent`, questa è la regione in cui i contenuti vengono messi in primo piano o in esclusiva. Utilizza i codici ISO 3166 per i paesi. Per indicarlo ovunque nel mondo, imposta `EARTH`.
`releasedEvent.startDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent`: la data di inizio della pubblicazione dell'entità. Per `PublicationEvent`, indica la data di uscita iniziale dell'entità, ad esempio la data in cui il film è stato pubblicato per la prima volta nei cinema. Per `ExclusiveEvent` e `FeaturedEvent`, rappresenta la data di inizio in cui l'entità diventa esclusiva o viene messa in primo piano.
`releasedEvent.endDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent`: applicabile solo ai tipi `ExclusiveEvent` e `FeaturedEvent`. Per `ExclusiveEvent`, rappresenta la data di scadenza dei diritti relativi ai contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il fornitore mette in primo piano l'entità. Se i contenuti sono in primo piano o esclusivi per sempre, imposta `endDate` su 20 anni dalla data corrente.
`releasedEvent.publishedBy`	Organization o Person	Facoltativo - L'organizzazione o la persona che ha pubblicato questa entità.
`description`	Testo	Altamente consigliato Perché? Un riassunto dell'episodio. È preferibile optare per le sinossi dei lotti piuttosto che per i riepiloghi oggettivi. Limite di 300 caratteri. Utilizza un array per eseguire il markup della descrizione in più lingue. Vedi l'esempio della 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, ["caratteristica, biografia"] può essere un insieme di parole chiave per descrivere i contenuti.
`actor`	Person, PerformingGroup o PerformanceRole	Altamente consigliato Perché? Un array dei membri del cast dell'episodio. Consulta le indicazioni sulla modellazione qui.
`director`	Person	Altamente consigliato Perché? I registi dell'episodio.
`producer`	Organization o Person	Altamente consigliato Perché? I produttori della stagione.
`image`	ImageObject	Molto consigliato Perché? per Google TV - Varie immagini correlate a TVEpisode. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere in `image`, consulta la sezione Proprietà delle immagini.
`trailer.description`	Testo	La descrizione del trailer. Vedi l'esempio del Trailer.
`trailer.inLanguage`	Testo	La lingua del trailer nel formato BCP 47.
`trailer.url`	URL	L'URL di un trailer ospitato pubblicamente e caricato dai rispettivi studi di produzione o da fonti autorizzate.
`trailer.regionsAllowed`	Luogo	Le regioni in cui i contenuti multimediali sono consentiti. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi nel formato ISO 3166.
`review`	Review	Esamina le classificazioni della puntata TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito il valore `review`. Viene utilizzato per specificare la valutazione fornita nella recensione.
`contentRating`	Testo o Valutazione	Obbligatorio per i contenuti per adulti, vivamente consigliato altrimenti: classificazione complessiva dei contenuti. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti: L'agenzia di classificazione è stata preceduta da uno spazio vuoto. Ad esempio, "TV-MA" valutazione dall'agenzia "TVPG" negli Stati Uniti deve essere descritta come "TVPG TV-MA". Consulta l'elenco delle agenzie. Il valore "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 valutazione.
`contentRating.advisoryCode`	Testo	Il codice di consulenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogo, FV = Violenza di fantasia, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza.
`identifier`	PropertyValue	Altamente consigliato Perché? - ID esterno o di altro tipo che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per informazioni dettagliate, consulta la sezione Proprietà dell'identificatore.
`popularityScore`	PopularityScoreSpecification	Altamente consigliato Perché? Punteggio utilizzato da Google, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo. pertanto la scala del punteggio deve essere coerente in tutti i feed, tra tutte le entità nel catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
`popularityScore.@type`	Testo	Imposta sempre su `PopularityScoreSpecification`.
`popularityScore.value`	Number	Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto corrisponde a una maggiore popolarità.
`popularityScore.eligibleRegion`	Paese	Regioni in cui è applicabile il punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su `EARTH`. Per impostazione predefinita, questa proprietà è impostata su `EARTH`. `Note:` La popolarità specifica per località ha la precedenza sulla popolarità globale (EARTH)

TVSeason

Proprietà	Tipo previsto	Descrizione
`@context`	Testo	Obbligatorio - Imposta sempre su `["http://schema.org", {"@language": "xx"}]` Dove" xx" rappresenta la lingua delle stringhe nel feed. In ogni contesto di entità principale deve essere impostato il codice @language sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, si presume che i nomi siano in spagnolo anche se la lingua dei sottotitoli e del doppiaggio è in inglese.
`@type`	Testo	Obbligatorio - Imposta sempre su `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 podcast cambia). Verrà trattata come una stringa opaca e non deve essere necessariamente un link funzionante. Sotto forma di URI (Unified Resource Identifier) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché il valore `url` di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare il valore `url` di un'entità come `@id`. Per ulteriori dettagli, consulta la sezione Identificatore.
`url`	URL	Obbligatorio: l'URL canonico dei contenuti, che Google utilizza per abbinare i contenuti del tuo feed ai contenuti nei database di Google. `url` deve soddisfare i seguenti requisiti: `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante di cui Google possa eseguire la scansione. Per il link diretto della riproduzione, vedi invece la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome della stagione TV. Utilizza un array per elencare i nomi in lingue diverse. Vedi l'esempio della rappresentazione in più lingue. Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
`titleEIDR`	Testo	Altamente consigliato Perché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta, a livello più generale/astratto, un'opera cinematografica o televisiva. Ad esempio, titleEIDR, per la prima stagione di TVSeries conosciuta come "Il Trono di Spade" è "10.5240/FD91-C72C-4161-FCBA-058B-1".
`seasonNumber`	Intero	Obbligatorio: il numero che indica la posizione della stagione in questione nell'ordine delle stagioni della serie TV.
`partOfSeries`	TVSeries	Obbligatorio: la serie TV a cui appartiene la stagione.
`partOfSeries.@type`	Testo	Obbligatorio - Imposta sempre su `TVSeries`.
`partOfSeries.@id`	URL	Obbligatorio: il `@id` di `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 in grado di identificare il programma. ad esempio la pagina 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 dell'azione deve fornire il link diretto dei contenuti. Se i contenuti sono disponibili su un canale LiveTV, questa proprietà è facoltativa. l'entità `BroadcastService` associata fornisce invece il link diretto del canale. Un `TVSeason` può essere disponibile sia su VOD e LiveTV. Utilizza un array per specificare link diretti diversi in più regioni. Vedi l'esempio Più regioni e lingue.
`sameAs`	URL	Altamente consigliato Perché? L'URL di una pagina web di riferimento in grado di identificare la stagione. ad esempio la pagina Wikipedia della stagione. Deve essere diverso dalla proprietà `url`.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` o `ExclusiveEvent`	Altamente consigliato Perché? - Viene utilizzato un `PublicationEvent` per specificare la pubblicazione originale (globale o locale) dei contenuti di un editore, ad esempio la data di uscita nei cinema originali di un film. Inoltre, utilizza `FeaturedEvent` per indicare che il tuo servizio commercializza questi contenuti come originali, in primo piano, speciali e così via. `ExclusiveEvent` indica che il tuo servizio ha diritti di distribuzione esclusivi e include dove e quando. Consulta la sezione degli esempi per dettagli ed esempi.
`releasedEvent.@type`	Testo	Obbligatorio - Assicurati di impostare sempre questa proprietà su uno dei seguenti valori: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorie: le regioni associate a questo evento. Per `PublicationEvent`, questa è la regione in cui sono stati pubblicati i contenuti. Per `FeaturedEvent` e `ExclusiveEvent`, questa è la regione in cui i contenuti vengono messi in primo piano o in esclusiva. Utilizza i codici ISO 3166 per i paesi. Per indicarlo ovunque nel mondo, imposta `EARTH`.
`releasedEvent.startDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent`: la data di inizio della pubblicazione dell'entità. Per `PublicationEvent`, indica la data di uscita iniziale dell'entità, ad esempio la data in cui il film è stato pubblicato per la prima volta nei cinema. Per `ExclusiveEvent` e `FeaturedEvent`, rappresenta la data di inizio in cui l'entità diventa esclusiva o viene messa in primo piano.
`releasedEvent.endDate`	Date o DateTime	Consigliato - Obbligatorio per `ExclusiveEvent`: applicabile solo ai tipi `ExclusiveEvent` e `FeaturedEvent`. Per `ExclusiveEvent`, rappresenta la data di scadenza dei diritti relativi ai contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il fornitore mette in primo piano l'entità. Se i contenuti sono in primo piano o esclusivi per sempre, imposta `endDate` su 20 anni dalla data corrente.
`releasedEvent.publishedBy`	Organization o Person	Facoltativo - L'organizzazione o la persona che ha pubblicato questa entità.
`description`	Testo	Altamente consigliato Perché? Un riassunto della stagione. È preferibile optare per le sinossi dei lotti piuttosto che per i riepiloghi oggettivi. Limite di 300 caratteri. Utilizza un array per eseguire il markup della descrizione in più lingue. Vedi l'esempio della rappresentazione in più lingue.
`actor`	[Person, PerformingGroup o PerformanceRole	Altamente consigliato Perché? Un array dei membri del cast della stagione. Consulta le indicazioni sulla modellazione qui.
`director`	Person	Altamente consigliato Perché? Un array dei registi del programma.
`producer`	Organization o Person	Altamente consigliato Perché? I produttori della stagione.
`image`	ImageObject	Le immagini relative a TVSeason. Per maggiori dettagli sulle proprietà obbligatorie e facoltative da includere in `image`, consulta la sezione Proprietà delle immagini.
`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, ["caratteristica, biografia"] può essere un insieme di parole chiave per descrivere i contenuti.
`trailer.description`	Testo	La descrizione del trailer. Vedi l'esempio del Trailer.
`trailer.inLanguage`	Testo	La lingua del trailer nel formato BCP 47.
`trailer.url`	URL	L'URL di un trailer ospitato pubblicamente e caricato dai rispettivi studi di produzione o da fonti autorizzate.
`trailer.regionsAllowed`	Luogo	Le regioni in cui i contenuti multimediali sono consentiti. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi nel formato ISO 3166.
`identifier`	PropertyValue	Altamente consigliato Perché? - ID esterno o di altro tipo che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per informazioni dettagliate, consulta la sezione Proprietà dell'identificatore.
`popularityScore`	PopularityScoreSpecification	Altamente consigliato Perché? Punteggio utilizzato da Google, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo. pertanto la scala del punteggio deve essere coerente in tutti i feed, tra tutte le entità nel catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
`popularityScore.@type`	Testo	Imposta sempre su `PopularityScoreSpecification`.
`popularityScore.value`	Number	Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto corrisponde a una maggiore popolarità.
`popularityScore.eligibleRegion`	Paese	Regioni in cui è applicabile il punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su `EARTH`. Per impostazione predefinita, questa proprietà è impostata su `EARTH`. `Note:` La popolarità specifica per località ha la precedenza sulla popolarità globale (EARTH)
`review`	Review	Esamina le classificazioni per la stagione TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito il valore `review`. Viene utilizzato per specificare la valutazione fornita nella recensione.
`contentRating`	Testo o Valutazione	Obbligatorio per i contenuti per adulti, vivamente consigliato altrimenti: classificazione complessiva dei contenuti. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti: L'agenzia di classificazione è stata preceduta da uno spazio vuoto. Ad esempio, "TV-MA" valutazione dall'agenzia "TVPG" negli Stati Uniti deve essere descritta come "TVPG TV-MA". Consulta l'elenco delle agenzie. Il valore "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 valutazione.
`contentRating.advisoryCode`	Testo	Il codice di consulenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogo, FV = Violenza di fantasia, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza.

Specifiche degli attori

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

Proprietà Tipo previsto Descrizione

Proprietà	Tipo previsto	Descrizione
`actor`	Person, PerformingGroup o PerformanceRole	Altamente consigliato Perché? : un array dei membri del cast. Usa il tipo PerformanceRole quando viene ricoperto il ruolo e (facoltativamente) il nome del carattere dei membri del cast è noto. In questo caso, l'attore Person o PerformingGroup è incorporato all'interno dell'oggetto PerformanceRole. Usa il tipo Person per indicare i singoli attori oppure PerformingGroup per fornire dettagli sui gruppi e sulle band che si esibiscono quando i ruoli interpretati dai membri del cast sono sconosciuti. Utilizza un array per rappresentare più persone, PerformingGroups o PerformanceRoles.

actor

Person, PerformingGroup o PerformanceRole

Altamente consigliato Perché? : un array dei membri del cast.

Usa il tipo PerformanceRole quando viene ricoperto il ruolo e (facoltativamente) il nome del carattere dei membri del cast è noto. In questo caso, l'attore Person o PerformingGroup è incorporato all'interno dell'oggetto PerformanceRole.
Usa il tipo Person per indicare i singoli attori oppure PerformingGroup per fornire dettagli sui gruppi e sulle band che si esibiscono quando i ruoli interpretati dai membri del cast sono sconosciuti.

Utilizza un array per rappresentare più persone, PerformingGroups o PerformanceRoles.

Utilizzo dei 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	Altamente consigliato Perché? - gli attori o l'identificatore 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 di performer L'ID deve essere stabile e non cambiare nel tempo. Verrà trattata come una stringa opaca e non deve essere necessariamente un link funzionante. Sotto forma di URI (Unified Resource Identifier) La tua organizzazione deve essere la proprietaria del 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 esistono due film con lo stesso attore, il valore `@id` deve essere mantenuto uguale in tutti i due oggetti attore.
`name`	Testo	Obbligatorio: il nome dell'attore/attrice/del membro del cast/del gruppo di attori.
`sameAs`	URL	Altamente consigliato Perché? - Un URL a una pagina web di riferimento in grado di identificare l'attore o il gruppo dello spettacolo; ad esempio la pagina Wikipedia dell'attore. Deve essere diverso dalla proprietà `@id`.

Utilizzo del tipo `PerformanceRole`

Quando viene utilizzato il tipo PerformanceRole, fornisci le seguenti proprietà

Proprietà	Tipo previsto	Descrizione
`@type`	PerformanceRole	Obbligatorio - Imposta sempre su PerformanceRole
`roleName`	Testo	Altamente 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 che ha recitato o interpretato. 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 Person. I gruppi/bande dei contenuti quando viene utilizzato il tipo di dati PerformingGroup.
`actor.@type`	Person o PerformingGroup	Obbligatorio - Imposta sempre su Person o PerformingGroup
`actor.@id`	URL	Altamente consigliato Perché? - L'attore o l'identificatore 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 di performer L'ID deve essere stabile e non cambiare nel tempo. Verrà trattata come una stringa opaca e non deve essere necessariamente un link funzionante. Sotto forma di URI (Unified Resource Identifier) La tua organizzazione deve essere la proprietaria del 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 esistono due film con lo stesso attore, il valore `@id` deve essere mantenuto uguale in tutti i due oggetti attore.
`actor.name`	Testo	Obbligatorio: il nome dell'attore/attrice/del membro del cast/del gruppo di attori.
`actor.sameAs`	URL	Altamente consigliato Perché? - Un URL a una pagina web di riferimento in grado di identificare l'attore o il gruppo dello spettacolo; ad esempio la pagina 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 ruolo cameo, chiamato anche apparizione cameo, è la breve apparizione di una persona nota in un'opera di arti dello spettacolo.
"Voce doppiata"	In una performance vocale, si intende una performance in cui viene utilizzata la voce dell'attore, che però non appare sullo schermo. Questo accade più comunemente nelle animazioni, ma si verifica anche quando la voce di un attore viene doppiata nel discorso di un altro attore.
"Doppio"	Per doppio si intende una persona che sostituisce un altro attore in modo tale che il suo volto non venga mostrato.
"Motion CaptureActor"	Un Motion CaptureActor si riferisce a una persona che registra le azioni di attori umani e utilizza queste informazioni per animare modelli di personaggi digitali in animazioni 2D o 3D al computer.

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

Valore `roleName`	Descrizione
"Attore"	Un attore è una persona che interpreta un personaggio in un'esibizione utilizzando il mezzo tradizionale del teatro o i media moderni come film, radio e televisione.
"GuestStar"	"Una guest star è un attore che interpreta un ruolo immaginario e appare in uno o alcuni episodi. In alcuni casi una guest star può recitare un importante personaggio ricorrente e apparire più volte in una serie, nonostante non faccia parte del cast principale. Imposta il valore su "GuestStar" quando il cast ha un'esibizione come ospite o è ospite del programma. Le guest star devono essere fornite solo a livello di puntata e non devono essere aggiunte a livello di TVSeries.
"Ospite"	"Ospite a un talk show. Tieni presente che mentre "GuestStar" è un ruolo fittizio, "Ospite" è un aspetto non fittizio.
"Annunciatore"	Un annuncio che parla di apertura e chiusura dello spettacolo, presenta il presentatore, i concorrenti e/o gli ospiti celebrità, descrive i premi disponibili, riscalda il pubblico prima della registrazione e lo intrattiene durante le pause.
"Commentatore"	Un commentatore fornisce i commenti in tempo reale di una partita o di un evento, solitamente durante una trasmissione live.
"Impressionista"	Un impressionista o un imitatore è un artista il cui atto consiste nell'imitare suoni, voci e manierismi di celebrità e personaggi dei cartoni animati.
"Host"	Persona che introduce, presenta o ospita programmi televisivi, spesso fungendo da mediatore per il programma e il pubblico. L'"organizzatore" è generalmente un ruolo non-fiction.
"Co-organizzatore"	Una persona che organizza un evento/programma in collaborazione con altre persone.
"Ospite"	Un conduttore ospite è un presentatore, di solito di un talk show, che ospita il programma al posto dell'organizzatore abituale, se non disponibile.
"Giornalista"	Una persona che presenta/informa il pubblico su novità ed eventi avvenuti a livello locale, nazionale e internazionale tramite un programma televisivo.
"Corrispondente"	Un corrispondente o reporter in diretta è solitamente un giornalista o un commentatore di una rivista, un agente che pubblica reportage su un giornale, su un notiziario radiofonico, televisivo o su un altro tipo di azienda, da un luogo remoto, spesso distante.
"Il giudice del programma"	Un giudice è una persona spesso considerata un'esperta nel campo dello spettacolo a cui viene assegnato il ruolo di "giudice" per criticare i concorrenti che fanno le audizioni e partecipano alla competizione della serie TV.
"Membro del panel"	Membro di un comitato consultivo o di discussione di un comitato radiofonico o televisivo.
"Concorrente"	Un concorrente di una competizione o di un quiz è una persona che partecipa al gioco.
"Narratore di storia"	Per narratore si intende una persona che racconta qualcosa, in particolare un personaggio che racconta gli eventi di un romanzo o di una poesia narrativa
"MusicalArtist"	"Un artista musicale può essere una persona, un gruppo o un personaggio di fantasia che solitamente si sono esibiti regolarmente davanti a un pubblico o che hanno registrato tracce o album musicali. Compositori e parolieri dovrebbero avere questo tipo solo se i riconoscimenti di alcune opere musicali implicano che contribuiscano anche come interprete principale. Questo tipo può essere utilizzato per associare musicisti o gruppi di musicisti permanenti e musicisti o gruppi di musicisti ospiti ai programmi.

Capire la differenza tra il ruolo principale e quello secondario di un attore

Per distinguere tra attori principali/normali e ospiti/supportanti di un programma TV, aggiungi il cast principale solo sulle entità TVSeries e aggiungi solo l'ospite o il cast con ruoli di supporto nelle entità TVEpisode. Assicurati che il cast principale/normale 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, si consiglia di fornire solo 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, si consiglia di fornire 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 sottoinsiemi di attori

Quando i metadati relativi ai ruoli nelle prestazioni non sono noti, si consiglia di fornire informazioni sull'attore utilizzando il tipo Person o PerformingGroup . Nell'altro caso in cui queste informazioni sono note, utilizza il tipo PerformanceRole . Questi tipi possono essere aggiunti 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 degli attori

Utilizzo dei tipi Person o PerformingGroup

Utilizzo del tipo PerformanceRole

Nomi dei ruoli accettabili

Capire la differenza 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 sottoinsiemi di attori

Pagine correlate

Utilizzo dei tipi `Person` o `PerformingGroup`

Utilizzo del tipo `PerformanceRole`

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

Esempi di proprietà `Actor`