Questa pagina è stata tradotta dall'API Cloud Translation.

Proprietà del markup dei contenuti dei 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 informazioni dettagliate, consulta la sezione Relazioni relative a 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 essere impostato su @language del codice lingua appropriato nel formato formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, i nomi si suppongono in spagnolo, anche se la lingua del sottotitolo/dub è in inglese.
`@type`	Testo	Obbligatorio: sempre impostato su `TVSeries`.
`@id`	URL	Obbligatorio: l'identificatore del contenuto in formato URI; ad esempio, https://example.com/1234abc. `@id` deve soddisfare i seguenti requisiti: Univoco a livello globale nel tuo catalogo L'ID dovrebbe essere stabile e non cambiare nel tempo (anche se la proprietà URL del programma cambia). verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. sotto forma di identificatore unificato di risorse (URI) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché la proprietà `url` di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare la proprietà `url` di un'entità come `@id`. Per ulteriori dettagli, consulta la sezione Identificatore.
`url`	URL	Obbligatorio: l'URL canonico dei contenuti, utilizzato da Google per abbinare i contenuti nel tuo feed a quelli nei database di Google. `url` deve soddisfare i seguenti requisiti: Il campo `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante che Google possa sottoporre a scansione. Per il link diretto della riproduzione, consulta invece la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome del programma. Utilizza un array per elencare i nomi in diverse lingue. Consulta l'esempio Più aree geografiche e lingue. Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
`titleEIDR`	Testo	Fortemente consigliatoPerché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta al livello più generale/astratto un'opera cinematografica o televisiva. Ad esempio, il titolo Feedfetcher per la serie TV noto 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 di 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. `TVSeries` è disponibile su VoD e LiveTV. Usa un array per specificare link diretti diversi in più aree geografiche. Consulta l'esempio Più aree geografiche e lingue.
`sameAs`	URL	Fortemente consigliatoPerché? Un URL a una pagina web di riferimento che può 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, ["funzionalità", biografia"] può essere un array di parole chiave per descrivere i contenuti.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` o `ExclusiveEvent`	Fortemente consigliatoPerché? - Un `PublicationEvent` viene utilizzato per specificare l'uscita originale (globale o locale) dei contenuti 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 ha diritti di distribuzione esclusivi e include dove e quando. Consulta la sezione di esempio per dettagli ed esempi.
`releasedEvent.@type`	Testo	Obbligatorio: assicurati di impostare sempre questa proprietà su una delle seguenti opzioni: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorio: le regioni associate a questo evento. Per `PublicationEvent`, si tratta della regione in cui i contenuti sono stati pubblicati. Per `FeaturedEvent` e `ExclusiveEvent`, si tratta della regione in cui i contenuti sono in primo piano o esclusivi. Utilizza i codici ISO 3166 per i paesi. Per indicare ovunque nel mondo, imposta su `EARTH`.
`releasedEvent.startDate`	Data 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 quella in cui il film è stato pubblicato per la prima volta nelle sale. Per `ExclusiveEvent` e `FeaturedEvent`, questo valore rappresenta la data di inizio del periodo in cui l'entità è esclusiva o in primo piano.
`releasedEvent.endDate`	Data o DateTime	Consigliato: obbligatorio per `ExclusiveEvent`. Si applica solo ai tipi `ExclusiveEvent` e `FeaturedEvent`. Per `ExclusiveEvent`, rappresenta la data di scadenza dei diritti dei contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il provider include l'entità. Se i contenuti sono perennemente esclusivi o in primo piano, imposta `endDate` su 20 anni dalla data corrente.
`releasedEvent.publishedBy`	Organizzazione o Persona	Facoltativo: l'organizzazione o la persona che ha pubblicato questa entità.
`description`	Testo	Fortemente consigliatoPerché? Una sinossi del programma. Per le sintesi dei grafici è preferibile utilizzare riepiloghi dei fatti. 300 caratteri. Utilizza un array per eseguire il markup della descrizione in più lingue. Consulta l'esempio Più aree geografiche e lingue.
`actor`	Person o PerformingGroup o PerformanceRole	Fortemente consigliatoPerché? Un array dei membri del cast della serie. Consulta le linee guida sulla definizione del modello qui.
`director`	Person	Fortemente consigliatoPerché? I registi del programma.
`producer`	Organizzazione o Persona	Fortemente consigliatoPerché? Il produttore o i produttori del programma.
`image`	ImageObject	Obbligatorio per Google TV: le immagini relative alla serie TV. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere in `image`, consulta le proprietà dell'immagine.
`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 da rispettive case di produzione o fonti autorizzate.
`trailer.regionsAllowed`	Luogo	Le regioni in cui sono consentiti i contenuti multimediali. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi in formato ISO 3166.
`identifier`	PropertyValue	Fortemente consigliatoPerché? - ID esterno o un altro ID che identifica in modo univoco questa entità. Sono ammessi più identificatori. Per ulteriori dettagli, consulta la sezione Proprietà degli identificatori.
`popularityScore`	PopolaritàPunteggio Specifica	Fortemente consigliatoPerché? Punteggio utilizzato da Google e da altri indicatori per stabilire quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto agli altri contenuti del tuo catalogo. Pertanto, la scala del punteggio deve essere coerente con tutti i 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	Imposta sempre su `PopularityScoreSpecification`.
`popularityScore.value`	Number	Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto significa maggiore popolarità.
`popularityScore.eligibleRegion`	Paese	Regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, imposta su `EARTH`. Per impostazione predefinita, questa proprietà è impostata su `EARTH`. `Note:` La popolarità specifica per locale ha la precedenza sulla popolarità a livello globale (EARTH)
`review`	Recensione	Classificazioni delle serie TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito `review` Utilizzato per specificare la valutazione attribuita nella recensione.
`contentRating`	Testo o Valutazione	Obbligatorio per i contenuti per adulti, ma altamente consigliato in caso contrario: la 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 ha anteposto la classificazione con uno spazio vuoto. 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 "VALUTAZIONE NON CONOSCIUTA" (senza distinzione tra maiuscole e minuscole) per indicare che non conosci la classificazione dei contenuti.
`contentRating.author`	Testo o Organizzazione	Obbligatorio se `contentRating` utilizza `Rating`: il nome dell'agenzia di valutazione. Consulta la pagina Agenzie per la classificazione dei contenuti per un elenco di 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 = Lingua, S = Contenuti di natura sessuale, V = Violenza.

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 essere impostato su @language del codice lingua appropriato nel formato formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, i nomi si suppongono in spagnolo, anche se la lingua del sottotitolo/dub è in inglese.
`@type`	Testo	Obbligatorio: sempre impostato su `TVEpisode`.
`@id`	URL	Obbligatorio: l'identificatore del contenuto in formato URI; ad esempio, https://example.com/1234abc. `@id` deve soddisfare i seguenti requisiti: Univoco a livello globale nel tuo catalogo L'ID dovrebbe essere stabile e non cambiare nel tempo (anche se la proprietà URL del programma cambia). verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. sotto forma di identificatore unificato di risorse (URI) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché la proprietà `url` di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare la proprietà `url` di un'entità come `@id`. Per ulteriori dettagli, consulta la sezione Identificatore.
`url`	URL	Obbligatorio: l'URL canonico dei contenuti, utilizzato da Google per abbinare i contenuti nel tuo feed a quelli nei database di Google. `url` deve soddisfare i seguenti requisiti: Il campo `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante che Google possa sottoporre a scansione. Per il link diretto della riproduzione, consulta invece la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome della puntata. Utilizza un array per elencare i nomi in diverse lingue. Vedi l'esempio di rappresentazione in più lingue. Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
`titleEIDR`	Testo	Fortemente consigliatoPerché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta al livello più generale/astratto un'opera cinematografica o televisiva. Ad esempio, titletitle della prima stagione della prima stagione di TVSeries nota come "Il Trono di Spade" è "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
`editEIDR`	Testo	Fortemente consigliatoPerché? - Un identificatore EIDR (Intrattenimento Identifier Registry) che rappresenta un'edizione o un'edizione specifica di un'opera cinematografica o televisiva. Ad esempio, il primo episodio della prima stagione di TVSeries noto come "Il Trono di Spade", il cui titolo è "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", include una modifica, ad esempio "10.5240/FB97-C847-2969-D0AB-EC". La proprietà `titleEIDR` è obbligatoria quando viene fornito il parametro editEIDR.
`inLanguage`	Testo	Lingua originale della serie nel formato BCP 47.
`episodeNumber`	Intero	Obbligatorio: il numero che indica la posizione di questa puntata nell'ordine delle puntate della stagione. `episodeNumber` deve essere riavviato per ogni stagione, ovvero il primo episodio di ogni stagione deve essere 1.
`partOfSeason`	Stagione TV	Obbligatorio: la stagione TV a cui appartiene questa puntata. Anche se un `TVEpisode` non ha un `TVSeason` corrispondente, devi fornire le proprietà `partOfSeason.@id` e `partOfSeason.seasonNumber`. Una soluzione alternativa è: Prendi `partofSeries.@id` (ad esempio http://www.example.com/my_preferred_tv_show) e allega un campo di query segnaposto (ad esempio ?week1) per creare un elemento `partOfSeason.@id` univoco (ad esempio http://www.example.com/my_preferred_tv_show? season1). Imposta `partOfSeason.seasonNumber` su 1.
`partOfSeason.@type`	Testo	Obbligatorio: sempre impostato su `TVSeason`.
`partOfSeason.@id`	URL	Obbligatorio: la `@id` di `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`	Serie TV	Obbligatorio: la serie TV a cui appartiene questa puntata.
`partOfSeries.@type`	Testo	Obbligatorio: sempre impostato su `TVSeries`.
`partOfSeries.@id`	URL	Obbligatorio: la `@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 che può 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 di 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. `TVEpisode` è disponibile su VoD e LiveTV. Usa un array per specificare link diretti diversi in più aree geografiche. Consulta l'esempio Più aree geografiche e lingue.
`sameAs`	Fortemente consigliatoPerché? URL	Un URL a una pagina web di riferimento che può identificare la puntata; per esempio, la pagina di Wikipedia dell'episodio. Deve essere diverso dalla proprietà `url`.
`duration`	Durata	Durata della puntata nel formato ISO 8601. Utilizza il formato: "PT00H00M".
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` o `ExclusiveEvent`	Fortemente consigliatoPerché? - Un `PublicationEvent` viene utilizzato per specificare l'uscita originale (globale o locale) dei contenuti 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 ha diritti di distribuzione esclusivi e include dove e quando. Consulta la sezione di esempio per dettagli ed esempi.
`releasedEvent.@type`	Testo	Obbligatorio: assicurati di impostare sempre questa proprietà su una delle seguenti opzioni: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorio: le regioni associate a questo evento. Per `PublicationEvent`, si tratta della regione in cui i contenuti sono stati pubblicati. Per `FeaturedEvent` e `ExclusiveEvent`, si tratta della regione in cui i contenuti sono in primo piano o esclusivi. Utilizza i codici ISO 3166 per i paesi. Per indicare ovunque nel mondo, imposta su `EARTH`.
`releasedEvent.startDate`	Data 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 quella in cui il film è stato pubblicato per la prima volta nelle sale. Per `ExclusiveEvent` e `FeaturedEvent`, questo valore rappresenta la data di inizio del periodo in cui l'entità è esclusiva o in primo piano.
`releasedEvent.endDate`	Data o DateTime	Consigliato: obbligatorio per `ExclusiveEvent`. Si applica solo ai tipi `ExclusiveEvent` e `FeaturedEvent`. Per `ExclusiveEvent`, rappresenta la data di scadenza dei diritti dei contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il provider include l'entità. Se i contenuti sono perennemente esclusivi o in primo piano, imposta `endDate` su 20 anni dalla data corrente.
`releasedEvent.publishedBy`	Organizzazione o Persona	Facoltativo: l'organizzazione o la persona che ha pubblicato questa entità.
`description`	Testo	Fortemente consigliatoPerché? Una sinossi dell'episodio. Per le sintesi dei grafici è preferibile utilizzare riepiloghi dei fatti. 300 caratteri. Utilizza un array per eseguire il markup della 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, ["funzionalità", biografia"] può essere un array di parole chiave per descrivere i contenuti.
`actor`	Person o PerformingGroup o PerformanceRole	Fortemente consigliatoPerché? Un array dei membri del cast della puntata. Consulta le linee guida sulla definizione del modello qui.
`director`	Person	Fortemente consigliatoPerché? I registi della puntata.
`producer`	Organizzazione o Persona	Fortemente consigliatoPerché? I produttori della stagione.
`image`	ImageObject	Vivamente consigliato Perché? per Google TV: varie immagini relative alla puntata TV. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere in `image`, consulta le proprietà dell'immagine.
`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 da rispettive case di produzione o fonti autorizzate.
`trailer.regionsAllowed`	Luogo	Le regioni in cui sono consentiti i contenuti multimediali. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi in formato ISO 3166.
`review`	Recensione	Controllare le valutazioni della puntata TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito `review` Utilizzato per specificare la valutazione attribuita nella recensione.
`contentRating`	Testo o Valutazione	Obbligatorio per i contenuti per adulti, ma altamente consigliato in caso contrario: la 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 ha anteposto la classificazione con uno spazio vuoto. 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 "VALUTAZIONE NON CONOSCIUTA" (senza distinzione tra maiuscole e minuscole) per indicare che non conosci la classificazione dei contenuti.
`contentRating.author`	Testo o Organizzazione	Obbligatorio se `contentRating` utilizza `Rating`: il nome dell'agenzia di valutazione. Consulta la pagina Agenzie per la classificazione dei contenuti per un elenco di 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 = Lingua, S = Contenuti di natura sessuale, V = Violenza.
`identifier`	PropertyValue	Fortemente consigliatoPerché? - ID esterno o un altro ID che identifica in modo univoco questa entità. Sono ammessi più identificatori. Per ulteriori dettagli, consulta la sezione Proprietà degli identificatori.
`popularityScore`	PopolaritàPunteggio Specifica	Fortemente consigliatoPerché? Punteggio utilizzato da Google e da altri indicatori per stabilire quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto agli altri contenuti del tuo catalogo. Pertanto, la scala del punteggio deve essere coerente con tutti i 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	Imposta sempre su `PopularityScoreSpecification`.
`popularityScore.value`	Number	Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto significa maggiore popolarità.
`popularityScore.eligibleRegion`	Paese	Regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, imposta su `EARTH`. Per impostazione predefinita, questa proprietà è impostata su `EARTH`. `Note:` La popolarità specifica per locale ha la precedenza sulla popolarità a livello globale (EARTH)

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 essere impostato su @language del codice lingua appropriato nel formato formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, i nomi si suppongono in spagnolo, anche se la lingua del sottotitolo/dub è in inglese.
`@type`	Testo	Obbligatorio: sempre impostato su `TVSeason`.
`@id`	URL	Obbligatorio: l'identificatore del contenuto in formato URI; ad esempio, https://example.com/1234abc. `@id` deve soddisfare i seguenti requisiti: Univoco a livello globale nel tuo catalogo L'ID dovrebbe essere stabile e non cambiare nel tempo (anche se la proprietà URL del programma cambia). verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. sotto forma di identificatore unificato di risorse (URI) Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione. Poiché la proprietà `url` di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare la proprietà `url` di un'entità come `@id`. Per ulteriori dettagli, consulta la sezione Identificatore.
`url`	URL	Obbligatorio: l'URL canonico dei contenuti, utilizzato da Google per abbinare i contenuti nel tuo feed a quelli nei database di Google. `url` deve soddisfare i seguenti requisiti: Il campo `url` deve essere univoco a livello globale `url` deve contenere un URL canonico funzionante che Google possa sottoporre a scansione. Per il link diretto della riproduzione, consulta invece la proprietà `urlTemplate` dell'oggetto target.
`name`	Testo	Obbligatorio: il nome di questa stagione TV. Utilizza un array per elencare i nomi in diverse lingue. Vedi l'esempio di rappresentazione in più lingue. Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
`titleEIDR`	Testo	Fortemente consigliatoPerché? - Un identificatore EIDR (Entertainment Identifier Registry) che rappresenta al livello più generale/astratto un'opera cinematografica o televisiva. Ad esempio, titletitle della prima stagione di TVSeries 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`	Serie TV	Obbligatorio: la serie TV a cui appartiene questa stagione.
`partOfSeries.@type`	Testo	Obbligatorio: sempre impostato su `TVSeries`.
`partOfSeries.@id`	URL	Obbligatorio: la `@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 che può 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 di 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. `TVSeason` è disponibile su VoD e LiveTV. Usa un array per specificare link diretti diversi in più aree geografiche. Consulta l'esempio Più aree geografiche e lingue.
`sameAs`	URL	Fortemente consigliatoPerché? Un URL a una pagina web di riferimento che può identificare la stagione, ad esempio la pagina Wikipedia della stagione. Deve essere diverso dalla proprietà `url`.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` o `ExclusiveEvent`	Fortemente consigliatoPerché? - Un `PublicationEvent` viene utilizzato per specificare l'uscita originale (globale o locale) dei contenuti 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 ha diritti di distribuzione esclusivi e include dove e quando. Consulta la sezione di esempio per dettagli ed esempi.
`releasedEvent.@type`	Testo	Obbligatorio: assicurati di impostare sempre questa proprietà su una delle seguenti opzioni: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Paese	Obbligatorio: le regioni associate a questo evento. Per `PublicationEvent`, si tratta della regione in cui i contenuti sono stati pubblicati. Per `FeaturedEvent` e `ExclusiveEvent`, si tratta della regione in cui i contenuti sono in primo piano o esclusivi. Utilizza i codici ISO 3166 per i paesi. Per indicare ovunque nel mondo, imposta su `EARTH`.
`releasedEvent.startDate`	Data 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 quella in cui il film è stato pubblicato per la prima volta nelle sale. Per `ExclusiveEvent` e `FeaturedEvent`, questo valore rappresenta la data di inizio del periodo in cui l'entità è esclusiva o in primo piano.
`releasedEvent.endDate`	Data o DateTime	Consigliato: obbligatorio per `ExclusiveEvent`. Si applica solo ai tipi `ExclusiveEvent` e `FeaturedEvent`. Per `ExclusiveEvent`, rappresenta la data di scadenza dei diritti dei contenuti. Per `FeaturedEvent`, rappresenta l'ultima data in cui il provider include l'entità. Se i contenuti sono perennemente esclusivi o in primo piano, imposta `endDate` su 20 anni dalla data corrente.
`releasedEvent.publishedBy`	Organizzazione o Persona	Facoltativo: l'organizzazione o la persona che ha pubblicato questa entità.
`description`	Testo	Fortemente consigliatoPerché? Una sinossi della stagione. Per le sintesi dei grafici è preferibile utilizzare riepiloghi dei fatti. 300 caratteri. Utilizza un array per eseguire il markup della descrizione in più lingue. Vedi l'esempio di rappresentazione in più lingue.
`actor`	[Persona, PerformingGroup o PerformanceRole	Fortemente consigliatoPerché? Una serie di membri del cast della stagione. Consulta le linee guida sulla definizione del modello qui.
`director`	Person	Fortemente consigliatoPerché? Una serie di registi del programma.
`producer`	Organizzazione o Persona	Fortemente consigliatoPerché? I produttori della stagione.
`image`	ImageObject	Le immagini relative alla TVSeason. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere in `image`, consulta le proprietà dell'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, ["funzionalità", biografia"] può essere un array 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 da rispettive case di produzione o fonti autorizzate.
`trailer.regionsAllowed`	Luogo	Le regioni in cui sono consentiti i contenuti multimediali. Se non specificato, si presume che sia consentito ovunque. Specifica i paesi in formato ISO 3166.
`identifier`	PropertyValue	Fortemente consigliatoPerché? - ID esterno o un altro ID che identifica in modo univoco questa entità. Sono ammessi più identificatori. Per ulteriori dettagli, consulta la sezione Proprietà degli identificatori.
`popularityScore`	PopolaritàPunteggio Specifica	Fortemente consigliatoPerché? Punteggio utilizzato da Google e da altri indicatori per stabilire quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto agli altri contenuti del tuo catalogo. Pertanto, la scala del punteggio deve essere coerente con tutti i 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	Imposta sempre su `PopularityScoreSpecification`.
`popularityScore.value`	Number	Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto significa maggiore popolarità.
`popularityScore.eligibleRegion`	Paese	Regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, imposta su `EARTH`. Per impostazione predefinita, questa proprietà è impostata su `EARTH`. `Note:` La popolarità specifica per locale ha la precedenza sulla popolarità a livello globale (EARTH)
`review`	Recensione	Valutazioni delle recensioni per la stagione TV
`review.reviewRating`	Valutazione	Obbligatorio se viene fornito `review` Utilizzato per specificare la valutazione attribuita nella recensione.
`contentRating`	Testo o Valutazione	Obbligatorio per i contenuti per adulti, ma altamente consigliato in caso contrario: la 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 ha anteposto la classificazione con uno spazio vuoto. 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 "VALUTAZIONE NON CONOSCIUTA" (senza distinzione tra maiuscole e minuscole) per indicare che non conosci la classificazione dei contenuti.
`contentRating.author`	Testo o Organizzazione	Obbligatorio se `contentRating` utilizza `Rating`: il nome dell'agenzia di valutazione. Consulta la pagina Agenzie per la classificazione dei contenuti per un elenco di 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 = Lingua, S = Contenuti di natura sessuale, V = Violenza.

Specifiche dell'attore

La proprietà actor nei tipi di entità TVSeries, TVEpisode e TVSeason ti consente di specificare ulteriori dettagli sugli attori, tra cui il nome dei loro personaggi e i ruoli che ricoprono nel programma TV. Le seguenti sezioni acquisiscono le stesse informazioni, con alcuni esempi che ne spiegano l'utilizzo.

Proprietà Tipo previsto Descrizione

Proprietà	Tipo previsto	Descrizione
`actor`	Person o PerformingGroup o PerformanceRole	Fortemente consigliatoPerché? : un array dei membri del cast. Usa il tipo PerformanceRole quando il ruolo ha svolto e (facoltativo) il nome del personaggio dei membri del cast. In questo caso, l'attore Person o PerformingGroup è incorporato all'interno dell'oggetto PerformanceRole. Utilizza il tipo Persona per indicare gli attori individuali o il PerformingGroup per fornire dettagli sui gruppi/le bande performanti quando i ruoli interpretati dai membri del cast sono sconosciuti. Utilizza un array per rappresentare più persone, PerformingGroups o PerformanceRole.

actor

Person o PerformingGroup o PerformanceRole

Fortemente consigliatoPerché? : un array dei membri del cast.

Usa il tipo PerformanceRole quando il ruolo ha svolto e (facoltativo) il nome del personaggio dei membri del cast. In questo caso, l'attore Person o PerformingGroup è incorporato all'interno dell'oggetto PerformanceRole.
Utilizza il tipo Persona per indicare gli attori individuali o il PerformingGroup per fornire dettagli sui gruppi/le bande performanti quando i ruoli interpretati dai membri del cast sono sconosciuti.

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

Utilizza 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 Persona o PerformingGroup
`@id`	URL	Fortemente consigliatoPerché? - Gli attori o l'identificatore di gruppo in esecuzione in formato URI; ad esempio, https://example.com/actor/abc. `@id` deve soddisfare i seguenti requisiti: Univoco a livello globale nel catalogo per attore/gruppo di destinazione L'ID dovrebbe essere stabile e non cambiare nel tempo. verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. sotto forma di identificatore unificato di risorse (URI) La tua organizzazione deve essere proprietaria del dominio utilizzato per il valore `@id`. Tieni presente che il `@id` utilizzato nella proprietà dell'attore deve essere utilizzato in modo coerente in tutto il feed. Ad esempio, se ci sono due filmati con lo stesso attore, il valore `@id` deve essere mantenuto lo stesso in questi due oggetti.
`name`	Testo	Obbligatorio: il nome dell'attore/attrice/membro del gruppo/gruppo di performance.
`sameAs`	URL	Fortemente consigliatoPerché? - L'URL di una pagina web di riferimento che può identificare l'attore o il gruppo performante; ad esempio la pagina Wikipedia dell'attore. Deve essere diverso dalla proprietà `@id`.

Utilizzo del tipo `PerformanceRole`

Fornisci le seguenti proprietà quando viene utilizzato il tipo PerformanceRole

Proprietà	Tipo previsto	Descrizione
`@type`	Prestazioni	Obbligatorio: sempre impostato su PerformanceRole
`roleName`	Testo	Fortemente consigliatoPerché? - Un ruolo svolto, eseguito o riempito dal membro del cast. Consulta l'elenco di valori accettati qui.
`characterName`	Testo	Il nome di un personaggio interpretato in un ruolo. Non impostare questo campo se il tipo di attore è PerformingGroup.
`actor`	Person o PerformingGroup	Obbligatorio - I membri del cast dei contenuti quando viene utilizzato il tipo di dati Persona. I gruppi/le fasce di rendimento dei contenuti quando viene utilizzato il tipo di dati PerformingGroup.
`actor.@type`	Person o PerformingGroup	Obbligatorio: sempre impostato su Persona o PerformingGroup
`actor.@id`	URL	Fortemente consigliatoPerché? - L'attore o l'identificatore di gruppo in esecuzione in formato URI; ad esempio, https://example.com/actor/abc. `@id` deve soddisfare i seguenti requisiti: Univoco a livello globale nel catalogo per attore/gruppo di destinazione L'ID dovrebbe essere stabile e non cambiare nel tempo. verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante. sotto forma di identificatore unificato di risorse (URI) La tua organizzazione deve essere proprietaria del dominio utilizzato per il valore `@id`. Tieni presente che il `@id` utilizzato nella proprietà dell'attore deve essere utilizzato in modo coerente in tutto il feed. Ad esempio, se ci sono due filmati con lo stesso attore, il valore `@id` deve essere mantenuto lo stesso in questi due oggetti.
`actor.name`	Testo	Obbligatorio: il nome dell'attore/attrice/membro del gruppo/gruppo di performance.
`actor.sameAs`	URL	Fortemente consigliatoPerché? - L'URL di una pagina web di riferimento che può identificare l'attore o il gruppo performante; ad esempio la pagina Wikipedia dell'attore. Deve essere diverso dalla proprietà actor.@id.

Nomi di ruolo accettabili

Questi valori richiedono che actor.@type sia Person.

Valore `roleName`	Descrizione
"Cameo"	Un ruolo di cammeo, detto anche "cammeo", è una breve apparizione di una persona famosa in un'opera di arti performative.
"Attore vocale"	Una performance vocale è quella in cui viene utilizzata la voce dell'attore, ma l'attore non appare sullo schermo. Questa situazione si trova più comunemente nell'animazione, ma si verifica anche quando la voce di un attore viene doppiata sul parlato di un altro attore.
"Doppio"	Un doppio è una persona che sostituisce un altro attore in modo che il volto della persona non venga mostrato.
"Cattura cattura movimento"	Un Motion CaptureActor si riferisce a una persona che registra azioni di attori umani e utilizza queste informazioni per animare modelli di personaggi digitali in animazioni al computer in 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 rappresenta un personaggio in uno spettacolo nel mezzo tradizionale del teatro o nei media moderni come film, radio e televisione.
"Ospite stella"	"Una star è un attore che ha un ruolo di fantasia e compare in uno o pochi episodi. In alcuni casi una star può recitare un ruolo importante e potrebbe apparire molte volte in una serie, anche se non fa parte del cast principale. Imposta il valore su "GuestStar" quando il cast ha una performance Ospite o è ospite del programma. Le stelle degli ospiti devono essere fornite solo a livello di puntata e non devono essere aggiunte a livello di TVSeries.
"Ospite"	"Un ospite di un talk show. Tieni presente che "GuestStar" è un ruolo fittizio, "Ospite" non ha un ruolo fittizio.
"Annunciatore"	Un presentatore è una persona che presenta spie di apertura e chiusura per lo spettacolo, presenta l'ospite, i concorrenti e/o gli ospiti di celebrità, descrive i premi disponibili e riscalda il pubblico prima di iniziare la registrazione, intrattenendoli durante le pause.
"Commentatore"	Un commentatore fornisce commenti in tempo reale su un gioco o un evento, generalmente durante una trasmissione dal vivo.
"Impressionista"	Un impressionista o imitazione è un artista il cui atto consiste nell'imitare suoni, voci e maneggiaggi di celebrità e personaggi dei cartoni animati.
"Host"	Persona che presenta, presenta o ospita programmi televisivi, svolgendo spesso un ruolo di mediatore per il programma e il pubblico. Il ruolo di "Host" è in genere un ruolo di saggistica.
"Co-organizzatore"	Una persona che ospita un evento/programma congiuntamente ad altre persone.
"HostHost"	Un organizzatore è un conduttore, di solito di un talk show, che ospita il programma al posto di quello regolare quando non è disponibile.
"Edicola"	Una persona che presenta/informa il pubblico su notizie ed eventi su scala locale, nazionale e internazionale nell'ambito di un programma di informazione TV.
"Corrispondente"	Un corrispondente o un giornalista sul campo è in genere un giornalista o un commentatore di una rivista oppure un agente che fornisce notizie a un giornale, a radio o notizie televisive oppure a un altro tipo di società da una località remota, spesso distante.
"ShowJudge"	Un giudice è una persona che viene spesso considerata un esperto nel campo dello spettacolo e ha il ruolo di "giudice" per criticare i concorrenti che partecipano a un'audizione e entrano nel concorso della serie TV.
"Membro del panel"	Membro di un panel di discussione o di consulenza di un panel radio o televisivo.
"Contestante"	Un concorrente in una competizione o in un quiz è una persona che vi partecipa.
"Narratore"	Un narratore è una persona che narra qualcosa, in particolare un personaggio che racconta gli eventi di un romanzo o una poesia narrativa
"Artista musicale"	"Un artista musicale può essere una persona, un gruppo o un personaggio di fantasia che regolarmente si esibisce davanti a un pubblico o che ha registrato tracce musicali o album musicali. I compositori e i parolieri dovrebbero avere questo tipo solo se i riconoscimenti di alcune opere musicali implicano anche che contribuiscono come principali artisti. Questo tipo può essere utilizzato per associare i musicisti o i gruppi di musicisti permanenti e i musicisti o i gruppi di musicisti ospiti dei programmi.

Differenze tra un ruolo principale e quello di supporto di un attore

Per distinguere gli attori principali/standard e ospiti/supportati di un programma TV, aggiungi il cast principale soltanto per le entità TVSeries e aggiungi soltanto il cast o il cast degli ospiti con ruoli di supporto sulle entità TVEpisode. Assicurati che il cast principale/standard 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"
    }
  ]
}

`Actor` esempio di proprietà

Ruolo dell'attore sconosciuto

Se il ruolo di un attore è sconosciuto, consigliamo di fornire le informazioni sull'attore utilizzando l'attributo persona 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, il nostro consiglio è quello 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 non sono noti i metadati del ruolo in base al rendimento, consigliamo di fornire le informazioni sull'attore utilizzando il tipo Persona o PerformingGroup . Per l'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à del markup dei contenuti dei programmi TV

Tabella delle specifiche

TVSeries

TVEpisode

TVSeason

Specifiche dell'attore

Utilizza i tipi Person o PerformingGroup

Utilizzo del tipo PerformanceRole

Nomi di ruolo accettabili

Differenze tra un ruolo principale e quello di supporto di un attore

Esempi

Esempio di TVSeries, TVEpisode e TVSeason

TVSeries

TVEpisode

TVSeason

Actor esempio di proprietà

Ruolo dell'attore sconosciuto

Il ruolo dell'attore è noto

Ruoli noti per un sottoinsieme di attori

Pagine correlate

Utilizza i tipi `Person` o `PerformingGroup`

Utilizzo del tipo `PerformanceRole`

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

`Actor` esempio di proprietà