Specifica di schema.org per i podcast

Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per i podcast.

Specifiche di PodcastSeries

PodcastSeries è la rappresentazione di una serie di podcast, che viene anche chiamata "programma" di podcast.

Proprietà	Priorità	Tipo	Descrizione
@context	Obbligatorio	Testo	Contesto di schema.org. Deve sempre essere impostato su [http://schema.googleapis.com,{@language}:xx}], dove xx deve trovarsi nel codice lingua. Imposta la lingua predefinita utilizzata per i valori di testo nell'entità.
@type	Obbligatorio	Testo	Deve essere sempre impostato su PodcastSeries.
@id	Obbligatorio	Testo	Un ID univoco globale per la serie di podcast in formato URI. L'ID deve essere stabile e non cambiare nel tempo. Viene considerato come una stringa opaca e non deve necessariamente essere un link funzionante. Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.
url	Obbligatorio	Testo	L'URL canonico del tuo sito web in cui la serie di podcast è presentata o descritta. Deve essere univoco a livello globale. Questo link consente di reconciliare con precisione i contenuti nel tuo feed con i contenuti nei database di Google. Per la riproduzione, utilizza target.urlTemplate descritto nella sezione ListenAction della documentazione.
name	Obbligatorio	Testo	Nome della serie di podcast. Includi un solo nome per lingua. Utilizza un array per eseguire il markup della descrizione in più lingue. Consulta l'esempio di più regioni e lingue.
description	Obbligatorio	Testo	Una sinossi della serie di podcast. Utilizza un array per eseguire il markup della descrizione in più lingue. Consulta l' esempio di più regioni e lingue.
alternativeHeadline	Facoltativo	Testo	Sottotitoli della serie di podcast.
author	Obbligatorio	Persona o organizzazione ripetuto	La persona o il gruppo che sviluppa o pubblica il programma. Spesso si riferisce all'host. Per esempi e dettagli, vedi Organizzazione, Persona (autore/editore).
publisher	Facoltativo	Persona o organizzazione ripetuto	Il gruppo o la rete originale responsabile della pubblicazione del programma. Spesso si riferisce a un'organizzazione responsabile della pubblicazione/produzione di diversi podcast. Per esempi e dettagli, consulta Organizzazione, Persona (autore/editore). Questo campo è vivamente consigliato per la disambiguazione e deve essere fornito ove applicabile.
actor	Facoltativo	Persona o organizzazione ripetuto	Attore del podcast. Per esempi e dettagli, consulta la sezione Attore (organizzatore/ospite) .
logo	Facoltativo	ImageObject ripetuto	Un'immagine del logo della serie. Fornisci questa informazione come ImageObject descritto in modo completo. Fornisci la risoluzione più alta disponibile. JPEG o PNG è preferito. Per dettagli ed esempi, consulta la sezione ImageObject (logo).
image	Obbligatorio	ImageObject ripetuto	Un'immagine dell'artwork della serie. Fornisci una descrizione completa ImageObject. Fornisci la risoluzione più alta disponibile. È preferibile JPEG o PNG. Per informazioni dettagliate e esempi, consulta la sezione ImageObject (logo).
isFamilyFriendly	Obbligatorio	Booleano	Indica se i contenuti sono adatti alle famiglie (ovvero se sono adatti a tutti i membri di una famiglia, compresi i bambini). I prodotti Google potrebbero utilizzare isFamilyFriendly per determinare quali contenuti riprodurre. Il valore deve essere true o false.
inLanguage	Obbligatorio	Testo	La lingua dei contenuti del podcast nel formato ISO 639-1. Questo valore può essere utilizzato per soddisfare le query degli utenti che richiedono contenuti in una lingua specifica.
genre	Obbligatorio	Testo ripetuto	La categoria o il genere della serie di podcast. Ad esempio, puoi seguire le categorie di podcast standard.
endDate	Facoltativo	Data	La data di uscita dell'ultima puntata della serie di podcast. Includi questo campo solo se la serie è già terminata.
rssFeed	Obbligatorio	URL	L'URL del feed RSS della serie di podcast.
potentialAction	Obbligatorio	ListenAction	L'azione da attivare per consentire agli utenti di ascoltare i contenuti. Per maggiori dettagli, consulta ListenAction.
popularityScore	Facoltativo	PopularityScoreSpecification	Un punteggio di popolarità che consente di determinare la priorità di pubblicazione quando sono presenti più candidati. Per dettagli ed esempi, consulta la sezione PopularityScoreSpecification (popularityScore).
keywords	Facoltativo	Testo ripetuto	Un elenco di parole chiave da associare alla serie di podcast. Queste parole chiave potrebbero essere utilizzate per espandere le query degli utenti che possono attivare questa serie di podcast. Ad esempio, nomi degli ospiti, argomenti trattati e così via.
sameAs	Facoltativo	URL	URL di una pagina web di riferimento di terze parti (non all'interno del tuo dominio) che indica in modo univoco l'identità dell'elemento. Questa pagina web viene utilizzata per la disambiguazione quando esistono più serie simili. Ad esempio, una pagina di Wikipedia o la home page della serie di podcast. Questo campo è vivamente consigliato per la disambiguazione della serie.
releasedEvent	Facoltativo	PublicationEvent o sottotipi più specifici: FeaturedEvent o ExclusiveEvent	L'evento che segna la pubblicazione o l'uscita della serie di podcast. Un evento di pubblicazione potrebbe indicare la prima uscita di un podcast da parte di un editore e i tipi più specializzati possono essere utilizzati per indicare l'esclusività o la messa in evidenza della pubblicazione. Per dettagli ed esempi, consulta la sezione PublicationEvent, FeaturedEvent, ExclusiveEvent (releasedEvent). Tieni presente che il contrassegno di una serie come esclusiva o in primo piano implica che tutte le puntate del programma sono esclusive o in primo piano.
countryOfOrigin	Facoltativo	Paese	Il paese delle sedi principali della società di produzione o della persona responsabile del podcast.

Specifiche PodcastEpisode

PodcastEpisode è la rappresentazione schema.org di una puntata all'interno di un PodcastSeries.

Proprietà	Priorità	Tipo	Descrizione
@context	Obbligatorio	Testo	Contesto di schema.org. Deve sempre essere impostato su [http://schema.googleapis.com,{@language:xx}] dove xx è il codice lingua. Imposta la lingua dei caratteri predefinita utilizzata per i valori di testo nel feed.
@type	Obbligatorio	Testo	Deve essere sempre impostato su PodcastEpisode.
@id	Obbligatorio	Testo	Un ID univoco globale per la puntata del podcast in formato URI. L'ID deve essere stabile e non cambiare nel tempo. Viene considerato come una stringa opaca e non deve necessariamente essere un link funzionante. La tua organizzazione deve possedere il dominio utilizzato per il valore @id.
url	Obbligatorio	Testo	L'URL canonico del tuo sito web in cui presenti o descrivi la puntata del podcast. Questo valore deve essere univoco a livello globale. Questo link viene utilizzato per contribuire a riconciliare con precisione i contenuti nel tuo feed con i contenuti nei database di Google. Per la riproduzione, viene utilizzato il target.urlTemplate descritto nella sezione ListenAction della documentazione.
name	Obbligatorio	Testo	Nome della puntata del podcast. Deve essere presente un solo nome per lingua. Utilizza un array per eseguire il markup della descrizione in più lingue. Consulta l'esempio con più regioni e lingue.
description	Obbligatorio	Testo	Descrizione della puntata del podcast.
alternativeHeadline	Obbligatorio	Testo	Sottotitolo della puntata del podcast.
author	Obbligatorio	Persona o organizzazione ripetuto	La persona o il gruppo che sviluppa o pubblica la puntata. Spesso questo valore fa riferimento all'host. Se l'autore corrisponde al programma, puoi riutilizzare le informazioni dell'entità PodcastSeries. Per esempi e dettagli, vedi Organizzazione, persona (autore/editore).
publisher	Obbligatorio	Persona o organizzazione ripetuto	Il gruppo o la rete originale responsabile della pubblicazione del programma. Spesso si riferisce a un'organizzazione responsabile della pubblicazione o della produzione di diversi podcast. Per esempi e dettagli, consulta Organizzazione, persona (autore/editore). Questo campo è vivamente consigliato per la disambiguazione e ti consigliamo di definirlo ove applicabile.
actor	Obbligatorio	Persona o organizzazione ripetuto	Attore del podcast. Per esempi e dettagli, consulta la sezione Attore (organizzatore/ospite).
datePublished	Obbligatorio	Data/ora	La data e l'ora di uscita della puntata del podcast. Questo valore viene utilizzato per ordinare la sequenza delle puntate e la disambiguazione.
episodeNumber	Obbligatorio	Numero intero	Il numero della puntata.
partOfSeries	Obbligatorio	PodcastSeries	La PodcastSeries in cui si trova questa puntata del podcast. Per maggiori dettagli ed esempi, consulta PodcastSeries(partOfSeries).
partOfSeason	Facoltativo	PodcastSeason	Per le serie composte da più stagioni, questa proprietà fornisce le informazioni sulle stagioni, nonché il numero e il nome della stagione. Per informazioni dettagliate ed esempi, consulta PodcastSeason(partOfSeason).
timeRequired	Obbligatorio	Durata	La durata della puntata nel formato della durata ISO 8601.
image	Facoltativo	ImageObject ripetuto	Un'immagine dell'artwork della serie. Deve essere un ImageObject descritto completamente. Fornisci la risoluzione più alta disponibile. JPEG o PNG è preferito. Per dettagli ed esempi, consulta la sezione ImageObject (logo).
isFamilyFriendly	Obbligatorio	Booleano	Indica se i contenuti sono adatti alle famiglie (ovvero se sono adatti a tutti i membri di una famiglia, inclusi i bambini). I prodotti Google potrebbero utilizzare isFamilyFriendly per determinare i contenuti da riprodurre. Il valore deve essere true o false.
inLanguage	Obbligatorio	Testo	La lingua dei contenuti della puntata del podcast nel formato ISO 639-1. Utilizza questo valore per soddisfare le query degli utenti che richiedono contenuti in una lingua specifica. Se i contenuti sono disponibili in più lingue, indica una sola lingua principale.
genre	Obbligatorio	Testo ripetuto	La categoria o il genere della serie di podcast. Ad esempio, puoi seguire le categorie di podcast standard.
associatedMedia	Facoltativo	AudioObject	Il file audio della puntata del podcast. Per dettagli ed esempi, consulta AudioObject(associatedMedia).
potentialAction	Obbligatorio	ListenAction	L'azione da attivare per consentire agli utenti di ascoltare i contenuti. Per maggiori dettagli, consulta la sezione ListenAction.
popularityScore	Facoltativo	PopularityScoreSpecification	Un punteggio di popolarità per determinare la priorità di pubblicazione quando sono presenti più candidati. Per dettagli ed esempi, consulta la sezione PopularityScoreSpecification.
keywords	Facoltativo	Testo ripetuto	Un elenco di parole chiave associate alla serie di podcast. Queste parole chiave potrebbero essere utilizzate per espandere le query degli utenti che possono attivare questa puntata del podcast. Ad esempio, news, sports o history.
identifier	Obbligatorio	PropertyValue ripetuto	Per PodcastEpisode, utilizza questa proprietà per fornire un GUID. Il GUID deve essere un ID che possa identificare in modo univoco e globale le puntate di un podcast. È diverso dal campo @id della puntata. Vedi ad esempio la sezione PropertyValue (identificatore).
sameAs	Facoltativo	URL	URL di una pagina web di riferimento di terze parti (non all'interno del tuo dominio) che indica in modo univoco l'identità dell'elemento. Google utilizza questa pagina web per la disambiguazione quando esistono più serie simili. Ad esempio, una pagina di Wikipedia o la home page delle puntate del podcast. Tieni presente che la pagina di riferimento a livello di serie non deve essere fornita qui. Consigliamo vivamente di utilizzare questo campo per la sambiguizzazione della puntata.
releasedEvent	Facoltativo	PublicationEvent o sottotipi più specifici: FeaturedEvent o ExclusiveEvent	L'evento che indica la pubblicazione o l'uscita della puntata del podcast. Un evento di pubblicazione potrebbe indicare la prima uscita di una puntata di un podcast da parte di un editore e i sottotipi più specifici possono indicare l'esclusività o la messa in evidenza della puntata. Per dettagli ed esempi, consulta la sezione PublicationEvent, FeaturedEvent, ExclusiveEvent (releasedEvent). Tieni presente che contrassegnare una serie come esclusiva o in primo piano sopra implica che tutte le sue puntate siano esclusive o in primo piano. Ti consigliamo di contrassegnare queste proprietà al livello più granulare.
countryOfOrigin	Facoltativo	Paese	Il paese delle sedi principali della società di produzione o del privato responsabile del podcast.

Nota: ti consigliamo di esaminare tutti i campi delle proprietà disponibili per CreativeWorkSeries e Episode. Ad esempio, la specifica del feed Google per PodcastSeries è un sottotipo di CreativeWorkSeries e PodcastEpisode è un sottotipo di Episode. Se esistono alcune proprietà che puoi fornire, ma che non sono incluse nelle tabelle precedenti, puoi comunque seguire la specifica schema.org per includerle nel tuo feed.

Ecco alcune proprietà che ti consigliamo di prendere in considerazione: editor, accountablePerson, dateModified, copyrightHolder, discussionUrl, actor e director.

PodcastSeries (partOfSeries)

Utilizza partOfSeries per stabilire la relazione tra un PodcastEpisode e il relativo PodcastSeries principale. Poiché i dettagli completi di PodcastSeries sono descritti nell'entità PodcastSeries separata, non è necessario fornire dettagli completi in partOfSeries. Devi fornire solo le seguenti proprietà:

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su PodcastSeries.
@id	Obbligatorio	URL	L'ID univoco globale della serie in formato URI. L'ID deve corrispondere all'ID dell'entità PodcastSeries completa nel feed.
name	Obbligatorio	Testo	Il nome della serie di podcast. Utilizza un array per eseguire il markup della descrizione in più lingue. Consulta l'esempio su Più regioni e lingue.

Esempio 1

"partOfSeries": {
  "@type": "PodcastSeries",
  "@id": "http://www.tjpodcast.org/series?id=1",
  "name": "Radiolab"
},

PodcastSeason (partOfSeason)

PodcastSeason rappresenta le informazioni sulla stagione di un PodcastEpisode, in particolare il numero della stagione. Hai bisogno di questa proprietà solo se la serie di podcast ha più stagioni.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Impostato sempre su PodcastSeason
@id	Obbligatorio	URL	Un ID univoco globale per la stagione in formato URI. L'ID deve essere stabile e non cambiare nel tempo. Viene considerato come una stringa opaca e non deve necessariamente essere un link funzionante.
seasonNumber	Obbligatorio	Numero intero	Il numero della stagione della serie di podcast.
name	Facoltativo	Testo	Il nome della stagione del podcast.

Esempio 1

"partOfSeason": {
  "@type": "PodcastSeason",
  "@id": "http://www.tjpodcast.org/seriesx/season?id=1",
  "seasonNumber": 1,
  "name": "Radiolab Season 1"
},

Organizzazione, persona (autore o editore)

Nota: Autore e editore

author nella maggior parte dei casi si riferisce all'organizzatore o al creatore della serie di podcast. Se gli host sono comunemente riconosciuti come gruppo invece che come persone singole, utilizza il tipo Organization e fornisci il nome del gruppo.

publisher è la persona o l'organizzazione che pubblica il programma. Può essere uguale all'autore quando la serie di podcast viene pubblicata in modo indipendente oppure può rappresentare la rete nel caso in cui il podcast venga pubblicato da un'organizzazione.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su Organization o Person.
@id	Obbligatorio	URL	Un ID univoco globale per l'organizzazione o la persona in formato URI. L'ID deve essere stabile e non cambiare nel tempo. Viene considerato come una stringa opaca e non deve necessariamente essere un link funzionante.
name	Obbligatorio	Testo	Il nome dell'organizzazione o della persona.
sameAs	Facoltativo	URL	URL di una pagina web di riferimento di terze parti (non all'interno del tuo dominio) che indica in modo univoco l'identità dell'elemento. Google utilizza questa pagina web per la disambiguazione quando esistono più serie simili. Alcuni esempi possono includere una pagina di Wikipedia per un'organizzazione o il sito web ufficiale dell'organizzazione.

Esempio 1

"author": {
  "@type": "Organization",
  "@id": "https://www.tjpodcast.org/organization/wnyc",
  "sameAs": "https://en.wikipedia.org/wiki/WNYC",
  "name": "WNYC"
},

Esempio 2

"author": {
  "@type": "Person",
  "@id": "https://www.tjpodcast.org/person/jad_abumrad",
  "sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad",
  "name": "Jad Abumrad"
},

Attore (organizzatore o ospite)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su Organization o Person.
@id	Obbligatorio	URL	Un ID univoco globale per l'organizzazione o la persona in formato URI. L'ID deve essere stabile e non cambiare nel tempo. Viene considerato come una stringa opaca e non deve necessariamente essere un link funzionante.
name	Obbligatorio	Testo	Il nome dell'organizzazione o della persona.
roleName	Obbligatorio	Testo	"Host" o "Ospite".
sameAs	Facoltativo	URL	URL di una pagina web di riferimento di terze parti (non all'interno del tuo dominio) che indica in modo univoco l'identità dell'elemento. Google utilizza questa pagina web per la disambiguazione quando esistono più serie simili. Alcuni esempi possono includere una pagina di Wikipedia per un'organizzazione o il sito web ufficiale dell'organizzazione.

Esempio 1

"actor":[{
  "@type": "PerformanceRole",
  "actor": {
    "@type": "Person",
    "@id": "https://www.tjpodcast.org/person/Roman",
    "name": {
      "@language":"en",
      "@value": "Roman Mars"
    },
    "roleName": "Host"
    "sameAs": "https://en.wikipedia.org/wiki/Roman",
  },
  "actor": {
    "@type": "Person",
    "@id": "https://www.tjpodcast.org/person/guest",
    "name":{
      "@language":"en",
      "@value": "Kurt Kohlstedt"
    },
    "roleName": "Guest"
   },
}]

ImageObject (logo o immagine)

ImageObject viene utilizzato per fornire il logo o l'artwork dei contenuti.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su ImageObject.
height	Facoltativo	Numero intero	Altezza dell'immagine in pixel.
width	Facoltativo	Numero intero	Larghezza dell'immagine in pixel.
contentUrl	Obbligatorio	URL	Un URL in cui è possibile trovare l'immagine.
regionsAllowed	Facoltativo	Paese ripetuto	I paesi in cui i contenuti multimediali sono consentiti: Se non specificato, si presume che l'immagine sia consentita in tutte le lingue. Per inviare immagini diverse per regione, aggiungi più proprietà ImageObject, ciascuna con il proprio insieme di paesi e un URL immagine corrispondente.

Paese (image.regionsAllowed)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Impostato sempre su Country.
name	Obbligatorio	Testo	Il codice paese ISO 3166-1 alpha-2. Ad esempio, GB, US.

Esempio 1

"logo": {
  "@type": "ImageObject",
  "height": "100",
  "width": "800",
  "contentUrl": "http://www.foo.com/img/67890.jpg",
},

Esempio 2

"logo": [
  {
    "@type": "ImageObject",
    "height": "100",
    "width": "800",
    "contentUrl": "http://www.foo.com/img/67890.jpg",
    "regionsAllowed": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "GB"
      }
    ]
  },
  {
    "@type": "ImageObject",
    "height": "100",
    "width": "800",
    "contentUrl": "http://www.foo.com/img/12345.jpg",
    "regionsAllowed": [
      {
        "@type": "Country",
        "name": "IN"
      },
      {
        "@type": "Country",
        "name": "PK"
      }
    ]
  },
],

PropertyValue (identificatore)

Se disponi di GUID per i tuoi contenuti, puoi fornire questi ID con il campo identifier per migliorare l'accuratezza della riconciliazione dei tuoi contenuti da parte di Google. Tieni presente che il GUID è obbligatorio per PodcastEpisode. Deve essere diverso dal campo @id della puntata (non all'interno del tuo dominio) e deve rappresentare la puntata di origine in modo globale e unico nel tempo, tra le varie fonti.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Impostato sempre su "PropertyValue".
propertyID	Obbligatorio	Testo	Deve essere sempre impostato su GUID.
value	Obbligatorio	Testo	Il GUID della serie o della puntata.

Esempio 1

"identifier": {
  "@type": "PropertyValue",
  "propertyID": "GUID",
  "value": "50204fe4-bc68-4b34-aae6-e73c700cc5ca"
},

PopularityScoreSpecification (popularityScore)

popularityScore può aiutare gli utenti a trovare i contenuti più appropriati, in scenari in cui i criteri della query dell'utente corrispondono a più entità del tuo feed. Quando questo valore è disponibile, all'utente vengono mostrati i contenuti con il punteggio di popolarità più alto disponibili per la sua regione. Per tutti i contenuti senza questo campo viene utilizzato per impostazione predefinita il punteggio di popolarità 0. Il confronto dei punteggi avviene nell'ambito del tuo catalogo completo, quindi assicurati che la scala sia coerente in tutti i tuoi feed.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su PopularityScoreSpecification.
value	Obbligatorio	Numerico	Un valore numerico positivo da confrontare con altre entità del tuo catalogo per la priorità di pubblicazione. Un numero più alto indica una maggiore popolarità.
eligibleRegion	Facoltativo	Paese o testo ripetuto	Una regione o un elenco di regioni a cui si applica questo punteggio di popolarità. Se il punteggio di popolarità si applica a livello globale, utilizza earth come valore text. Se è necessario elencare regioni specifiche, utilizza il tipo "Paese". Se lasci vuoto questo campo, il valore predefinito di eligibleRegion è earth.

Paese (popularityScore.eligibleRegion)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su Country.
name	Obbligatorio	Testo	Il codice paese ISO 3166-1 alpha-2. Ad esempio, GB, US.

Esempio 1

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 4.3,
  "eligibleRegion": "Earth"
},

Esempio 2

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 2,
  "eligibleRegion": {
    "@type": "Country",
    "name": "US"
  }
},

Esempio 3

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 101,
  "eligibleRegion": [
    {
      "@type": "Country",
      "name": "US"
    },
    {
      "@type": "Country",
      "name": "GB"
    }
  ]
},

PublicationEvent, FeaturedEvent, ExclusiveEvent (releasedEvent)

PublicationEvent

Utilizza questo oggetto per rappresentare la data e la località di pubblicazione di un programma o di una puntata (nota anche come "data di uscita" di una serie o di una puntata). Inoltre, il campo publishedBy indica l'entità che pubblica o distribuisce la serie o la puntata del podcast.

ExclusiveEvent

Utilizza questo oggetto per indicare che il fornitore detiene i diritti di distribuzione esclusivi per il podcast. L'esclusività può essere specifica per regione e limitata nel tempo e deve includere il campo dell'organizzazione che rimanda al fornitore esclusivo dei contenuti.

FeaturedEvent

Utilizza questo oggetto per indicare che il fornitore mostra il podcast ai consumatori (ad esempio come "originale").

Originals è diverso da Esclusivo

Il termine "originali (in primo piano)" spesso indica i diritti esclusivi di una determinata entità, il che ne causa il sovraccarico. Di conseguenza, il significato previsto deve essere suddiviso nelle due categorie sopra indicate. È possibile che un'entità originale sia anche esclusiva e, in questo caso, releasedEvent può accettare un array con entrambi i tipi di eventi nella stessa entità.

Tieni presente che, sebbene l'esclusività o la presenza in primo piano possano avere significati simili nel catalogo di un fornitore, PublicationEvent si applica in modo più generale per consentire la disambiguazione delle entità e fornire metadati aggiuntivi sulle stesse, come la data di uscita di una serie o di una puntata.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve sempre essere impostato su uno dei valori PublicationEvent, ExclusiveEvent o FeaturedEvent.
location	Obbligatorio	Paese	La regione in cui si verifica l'evento di pubblicazione. Puoi utilizzarlo anche per rappresentare le limitazioni di esclusività e di distribuzione dell'entità. Utilizza i codici ISO 3166 per il paese. Se devi applicare la semantica globale, imposta il valore su EARTH. Imposta esplicitamente location su EARTH, nel caso in cui le limitazioni specifiche per le impostazioni internazionali non siano applicabili.
startDate	Consigliato (obbligatorio per ExclusiveEvent)	Data o DateTime	Data di inizio della pubblicazione delle entità. Nel caso di PublicationEvent, indica la data di uscita iniziale di questa entità. Nel caso di ExclusiveEvent o FeaturedEvent, rappresenta la data di inizio dell'esclusività o della funzionalità in primo piano dell'entità.
endDate	Consigliato (obbligatorio per ExclusiveEvent)	Data o DateTime	Data di fine della pubblicazione delle entità. Nel caso di PublicationEvent, indica la data di pubblicazione finale dell'entità. Nel caso di ExclusiveEvent o FeaturedEvent, rappresenta la data di fine dell'esclusività o della funzionalità in primo piano dell'entità.
publishedBy	Obbligatorio	Persona o organizzazione	L'entità Organization o Person che pubblica questa entità e si applica a questo evento di pubblicazione. Utilizza lo stesso schema descritto nella sezione Organizzazione (autore/Editore).

Esempio 1

"releasedEvent": [ {
  "@type": "PublicationEvent",
  "location": "EARTH",
  "startDate": "2016-04-21T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/wnyc",
    "sameAs": "https://en.wikipedia.org/wiki/WNYC",
    "name": "WNYC"
  },
 }, {
  "@type": "FeaturedEvent",
  "location": "US",
  "startDate": "2020-04-18T20:00",
  "endDate": "2020-04-21T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 },
]

Esempio 2

"releasedEvent": [ {
  "@type": "FeaturedEvent",
  "location": "US",
  "startDate": "2020-04-18T20:00",
  "endDate": "2020-05-21T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 }, {
  "@type": "ExclusiveEvent",
  "location": "US",
  "startDate": "2020-04-18T20:00",
  "endDate": "2020-04-24T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 }, {
  "@type": "ExclusiveEvent",
  "location": "CA",
  "startDate": "2020-04-21T20:00",
  "endDate": "2020-04-24T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 }
]

AudioObject (associatedMedia)

AudioObject viene utilizzato per fornire il file multimediale non elaborato della puntata del podcast.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su AudioObject.
contentUrl	Obbligatorio	URL	L'URL del file multimediale.
contentSize	Obbligatorio	Numero intero	Le dimensioni del file multimediale in byte.
encodingFormat	Obbligatorio	Testo	I tipi di media IANA del file multimediale. Ad esempio, audio/mpeg.
duration	Obbligatorio	Durata	La durata dei contenuti multimediali nel formato della durata ISO 8601.
transcript	Facoltativo	Testo	Trascrizione della puntata.
bitrate	Facoltativo	Testo	La velocità in bit del file multimediale.
name	Facoltativo	Testo	Il nome del file multimediale.

Esempio 1

"associatedMedia": {
    "@type": "AudioObject",
    "contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
    "duration": "PT5M32S",
    "contentSize": "53616000",
    "encodingFormat": "audio/mpeg",
    "name": "radiolab_podcast19.mp3",
    "transcript": "Transcript of the episode",
    "bitrate": "64Kbps"
},

ListenAction (potentialAction)

L'entità ListenAction definisce i tuoi link diretti per la riproduzione e i criteri per gli utenti (ad esempio dati geografici, cronologici, di accesso o stato dell'abbonamento) per accedere ai contenuti.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su ListenAction.
target	Obbligatorio	EntryPoint ripetuto	Le specifiche del tuo link diretto con le informazioni sulla piattaforma supportata. Puoi utilizzare più campi EntryPoint per definire link diretti diversi per più set di piattaforme.
actionAccessibilityRequirement	Obbligatorio	ActionAccessSpecification ripetuto	La definizione dei requisiti di accesso degli utenti a questa entità. Se sono presenti più ActionAccessSpecification, un utente che soddisfa uno qualsiasi dei criteri di specifica può accedere ai contenuti.

EntryPoint (potentialAction.target)

table class="fixed"> Proprietà Priorità Tipo Descrizione @type Obbligatorio Testo Imposta sempre su EntryPoint. urlTemplate Obbligatorio URL Il link utilizzato per avviare la riproduzione dei tuoi contenuti. actionPlatform Obbligatorio

Testo

ripetuto

La piattaforma per la quale questo link diretto è valido. Ecco i valori possibili:

• "http://schema.org/DesktopWebPlatform"
• "http://schema.org/MobileWebPlatform"
• "http://schema.org/AndroidPlatform"
• "http://schema.org/AndroidTVPlatform"
• "http://schema.org/IOSPlatform"
• "http://schema.googleapis.com/GoogleAudioCast"
• "http://schema.googleapis.com/GoogleVideoCast"

ActionAccessSpecification (potentialAction.actionAccessibilityRequirement)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su ActionAccessSpecification.
category	Obbligatorio	Testo	Il tipo di requisito di accesso. Deve essere uno dei seguenti valori: nologinrequired: l'azione è disponibile per l'utente senza necessità di acquisto o di accesso per accedere ai contenuti. free: l'azione è disponibile senza necessità di acquisto o abbonamento a pagamento per l'utente. L'azione richiede tuttavia che un utente esegua l'accesso. subscription: l'azione è inclusa in un abbonamento pagato al tuo servizio.
availabilityStarts	Facoltativo	Data/ora	L'ora di inizio della finestra di disponibilità. Puoi utilizzarla per controllare il momento esatto in cui questi contenuti possono essere mostrati agli utenti.
availabilityEnds	Facoltativo	Data/ora	L'ora di fine della finestra di disponibilità. Puoi utilizzarla per controllare il momento esatto in cui i contenuti non saranno più esposti agli utenti.
eligibleRegion	Obbligatorio	Paese ripetuto	Il paese idoneo per questa offerta. Puoi utilizzarlo per controllare il paese o la regione in cui devono essere disponibili questi contenuti.
requiresSubscription	Obbligatorio se applicabile	MediaSubscription	Il pacchetto di abbonamento necessario per accedere a questi contenuti. Se il tuo servizio offre più pacchetti di abbonamento, questo campo è obbligatorio. Se il servizio è senza costi o se esiste un solo livello di abbonamento, puoi saltare questo campo.

Paese (potentialAction.actionAccessibilityRequirement.eligibleRegion)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su Country.
name	Obbligatorio	Testo	Il codice paese ISO 3166-1 alpha 2.

Abbonamento a contenuti multimediali (potentialAction.actionAccessibilityRequirement.requiresSubscription)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su MediaSubscription.
@id	Obbligatorio	URL	Un ID univoco globale per il pacchetto di abbonamenti in formato URI. L'ID deve essere stabile e non cambiare nel tempo. Viene considerato come una stringa opaca e non deve necessariamente essere un link funzionante.
name	Obbligatorio	Testo	Il nome del pacchetto dell'abbonamento. Ad esempio Premium, Basic.
expectsAcceptanceOf	Consigliato	Offerta	L'offerta associata all'acquisto dell'abbonamento Media. Puoi utilizzarlo per esprimere il prezzo dell'abbonamento.

Offerta (potentialAction.actionAccessibilityRequirement.requiresSubscription.expectsAcceptanceOf)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Deve essere sempre impostato su Offer.
price	Obbligatorio	Numero	Il prezzo dell'abbonamento.
priceCurrency	Obbligatorio	Testo	La valuta (in formato ISO 4217 a tre lettere) del prezzo.
seller	Consigliato	Organizzazione	L'organizzazione che offre l'abbonamento o l'acquisto dell'azione. Utilizza lo stesso schema descritto nella sezione Organizzazione (autore/Editore).

Esempio 1

"potentialAction": {
    "@type": "ListenAction",
    "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
        "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/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
        ]
    },
    "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "nologinrequired",
        "availabilityStarts": "2018-04-01T11:01:00-04:00",
        "availabilityEnds": "2018-06-30T23:59:00-04:00",
        "eligibleRegion": {
            "@type": "Country",
            "name": "US"
        }
    }
},

Esempio 2

"potentialAction": {
    "@type": "ListenAction",
    "target": [
        {
            "@type": "EntryPoint",
            "urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
            "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/MobileWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://schema.org/AndroidTVPlatform",
                "http://schema.org/IOSPlatform"
            ]
        },
        {
            "@type": "EntryPoint",
            "urlTemplate": "https://www.tjpodcast.org/castlink?streamStationId=170",
            "actionPlatform": [
                "http://schema.googleapis.com/GoogleAudioCast",
                "http://schema.googleapis.com/GoogleVideoCast"
            ]
        }
    ],
    "actionAccessibilityRequirement": [
        {
            "@type": "ActionAccessSpecification",
            "category": "nologinrequired",
            "availabilityStarts": "2018-04-01T11:01:00-04:00",
            "availabilityEnds": "2018-06-30T23:59:00-04:00",
            "eligibleRegion": [
                {
                    "@type": "Country",
                    "name": "IN"
                },
                {
                    "@type": "Country",
                    "name": "GB"
                }
            ]
        },
        {
            "@type": "ActionAccessSpecification",
            "category": "Subscription",
            "requiresSubscription": {
                "@type": "MediaSubscription",
                "@id": "http://www.example.com/packages/basic-pack",
                "name": "Basic Pack",
                "expectsAcceptanceOf": {
                    "@type": "Offer",
                    "price": 8.99,
                    "priceCurrency": "USD"
                }
            },
            "availabilityStarts": "2018-04-01T11:01:00-04:00",
            "availabilityEnds": "2018-06-30T23:59:00-04:00",
            "eligibleRegion": {
                "@type": "Country",
                "name": "US"
            }
        }
    ]
},

Appendice

Esempio completo

{
    "@context": "http://schema.org",
    "@type": "DataFeed",
    "dateModified": "2018-09-10T13:58:26.892Z",
    "dataFeedElement": [
        {
            "@context": [
                "http://schema.googleapis.com",
                {
                    "@language": "en"
                }
            ],
            "@type": "PodcastSeries",
            "@id": "http://www.tjpodcast.org/series?id=2",
            "url": "http://www.tjpodcast.org/series?id=2",
            "name": "Radiolab",
            "description": "A two-time Peabody Award-winner...",
            "alternativeHeadline": "Radiolab - Powered by WNYC",
            "sameAs": "https://en.wikipedia.org/wiki/Radiolab",
            "image": {
                "@type": "ImageObject",
                "height": "100",
                "width": "800",
                "contentUrl": "http://www.tjpodcast.org/img/2.jpg"
            },
            "logo": {
                "@type": "ImageObject",
                "height": "100",
                "width": "800",
                "contentUrl": "http://www.tjpodcast.org/logo/2/1.jpg"
            },
            "keywords": [
                "Science",
                "Technology",
                "Philosophy",
                "Education"
            ],
            "author": [
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/jad_abumrad",
                    "name": "Jad Abumrad",
                    "sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
                },
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/robert_krulwich",
                    "name": "Robert Krulwich",
                    "sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
                }
            ],
            "publisher": {
                "@type": "Organization",
                "name": "WNYC",
                "@id": "https://www.tjpodcast.org/network/wnyc_studios",
                "sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
            },
            "isFamilyFriendly": "True",
            "inLanguage": "en",
            "genre": [
                "Science & Medicine",
                "Natural Sciences"
            ],
            "endDate": "2017-12-22T08:59:00",
            "rssFeed": "http://feeds.wnyc.org/radiolab",
            "potentialAction": {
                "@type": "ListenAction",
                "target": {
                    "@type": "EntryPoint",
                    "urlTemplate": "https://www.tjpodcast.org/?streamSeriesId=2",
                    "actionPlatform": [
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.googleapis.com/GoogleAudioCast",
                        "http://schema.googleapis.com/GoogleVideoCast"
                    ]
                },
                "actionAccessibilityRequirement": {
                    "@type": "ActionAccessSpecification",
                    "category": "nologinrequired",
                    "availabilityStarts": "2018-04-01T11:01:00-04:00",
                    "availabilityEnds": "2019-12-30T23:59:00-04:00",
                    "eligibleRegion": {
                        "@type": "Country",
                        "name": "FR"
                    }
                }
            },
            "popularityScore": {
                "@type": "PopularityScoreSpecification",
                "value": 4.2
            }
        },
        {
            "@context": [
                "http://schema.googleapis.com",
                {
                    "@language": "en"
                }
            ],
            "@type": "PodcastEpisode",
            "@id": "http://www.tjpodcast.org/episode?id=1",
            "url": "http://www.tjpodcast.org/episode?id=1",
            "name": "A Clockwork Miracle",
            "description": "As legend goes, in 1562, King Philip II...",
            "sameAs": "https://www.wnycstudios.org/story/radiolab-clockwork-miracle",
            "image": {
                "@type": "ImageObject",
                "height": "100",
                "width": "800",
                "contentUrl": "http://www.tjpodcast.org/img/2/1.jpg"
            },
            "keywords": [
                "Education",
                "Philosophy",
                "Science",
            ],
            "partOfSeries": {
                "@type": "PodcastSeries",
                "@id": "http://www.tjpodcast.org/series?id=2",
                "name": "Radiolab",
                "sameAs": "https://en.wikipedia.org/wiki/Radiolab",
            },
            "episodeNumber": 101,
            "inLanguage": "en",
            "author": [
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/jad_abumrad",
                    "name": "Jad Abumrad",
                    "sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
                },
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/robert_krulwich",
                    "name": "Robert Krulwich",
                    "sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
                }
            ],
            "publisher": {
                "@type": "Organization",
                "name": "WNYC",
                "@id": "https://www.tjpodcast.org/network/wnyc_studios",
                "sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
            },
            "isFamilyFriendly": "True",
            "genre": [
                "Science",
                "Philosophy",
                "Fiction"
            ],
            "datePublished": "2018-12-27T23:23:00Z",
            "timeRequired": "PT22M",
            "associatedMedia": {
                "@type": "AudioObject",
                "contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
                "duration": "PT21M45S",
                "contentSize": "53616000",
                "encodingFormat": "audio/mpeg",
                "transcript": "Transcript of the episode",
                "bitrate": "64Kbps"
            },
            "potentialAction": {
                "@type": "ListenAction",
                "target": {
                    "@type": "EntryPoint",
                    "urlTemplate": "https://www.tjpodcast.org/?streamEpisodeId=1",
                    "actionPlatform": [
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.googleapis.com/GoogleAudioCast",
                        "http://schema.googleapis.com/GoogleVideoCast"
                    ]
                },
                "actionAccessibilityRequirement": {
                    "@type": "ActionAccessSpecification",
                    "category": "nologinrequired",
                    "availabilityStarts": "2018-04-01T11:01:00-04:00",
                    "availabilityEnds": "2019-12-30T23:59:00-04:00",
                    "eligibleRegion": {
                        "@type": "Country",
                        "name": "FR"
                    }
                }
            },
            "popularityScore": {
                "@type": "PopularityScoreSpecification",
                "value": 3.8
            },
            "identifier": [
                {
                    "@type": "PropertyValue",
                    "propertyID": "GUID",
                    "value": "53ff386e-e768-40b5-8854-1b7415826ded"
                }
            ]
        }
    ],
    "actor": [
        {
            "@type": "PerformanceRole",
            "actor": {
                "@type": "Person",
                "@id": "https://www.tjpodcast.org/person/Roman",
                "name": {
                    "@language": "en",
                    "@value": "Roman Mars"
                },
                "roleName": "Host",
                "sameAs": "https://en.wikipedia.org/wiki/Roman"
            },
            "actor": {
                "@type": "Person",
                "@id": "https://www.tjpodcast.org/person/guest",
                "name": {
                    "@language": "en",
                    "@value": "Kurt Kohlstedt"
                },
                "roleName": "Guest"
            }
        }
    ],
    "releasedEvent": [
        {
            "@type": "FeaturedEvent",
            "location": "US",
            "startDate": "2020-04-18T20:00",
            "endDate": "2020-05-21T20:00",
            "publishedBy": {
                "@type": "Organization",
                "@id": "https://www.tjpodcast.org/organization/tjpodcast",
                "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
                "name": "TJPodcast"
            }
        },
        {
            "@type": "ExclusiveEvent",
            "location": "US",
            "startDate": "2020-04-18T20:00",
            "endDate": "2020-04-24T20:00",
            "publishedBy": {
                "@type": "Organization",
                "@id": "https://www.tjpodcast.org/organization/tjpodcast",
                "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
                "name": "TJPodcast"
            }
        },
        {
            "@type": "ExclusiveEvent",
            "location": "CA",
            "startDate": "2020-04-21T20:00",
            "endDate": "2020-04-24T20:00",
            "publishedBy": {
                "@type": "Organization",
                "@id": "https://www.tjpodcast.org/organization/tjpodcast",
                "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
                "name": "TJPodcast"
            }
        }
    ]
}