Specifica di schema.org dei podcast

Questa sezione fornisce i dettagli relativi alle proprietà del markup dei contenuti per i podcast.

Specifiche di PodcastSeries

PodcastSeries è la rappresentazione di una serie di podcast, anche nota come "programma" di podcast.

Proprietà	Priorità	Tipo	Descrizione
@context	Obbligatorio	Testo	Contesto di schema.org. Imposta sempre su [http://schema.googleapis.com,{@language}:xx}], dove xx deve essere nel codice lingua. Questa imposta la lingua predefinita utilizzata per i valori di testo nell'entità.
@type	Obbligatorio	Testo	Imposta sempre 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 corso del tempo. Viene trattato come una stringa opaca e non deve essere un link funzionante. Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.
url	Obbligatorio	Testo	L'URL canonico sul tuo sito web in cui la serie di podcast viene presentata o descritta. Deve essere univoco a livello globale. Questo link permette di riconciliare con precisione i contenuti nel tuo feed con i contenuti nei database di Google. Per la riproduzione, utilizza l'target.urlTemplate dettagliato 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ù aree geografiche e lingue.
description	Obbligatorio	Testo	Una sinossi della serie podcast. Utilizza un array per eseguire il markup della descrizione in più lingue Consulta l'esempio per più aree geografiche 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 consultare esempi e dettagli, vedi Organizzazione, Persona (autore/editore).
publisher	Facoltativo	Persona o organizzazione ripetuto	Il gruppo o la rete originali responsabili della pubblicazione del programma. Spesso si riferisce a un'organizzazione responsabile della pubblicazione/produzione di più podcast. Per esempi e dettagli, consulta Organizzazione, Persona (autore/editore). Questo campo è altamente consigliato per la disambiguazione e deve essere fornito laddove 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 questo in una descrizione completa di ImageObject. Fornisci la risoluzione più alta disponibile. È preferibile usare il formato JPEG o PNG. Per dettagli ed esempi, consulta la sezione ImageObject (logo).
image	Obbligatorio	ImageObject ripetuto	Un'immagine della serie. Fai riferimento a questo come una descrizione completa ImageObject. Fornisci la risoluzione più alta disponibile. È preferibile usare il formato JPEG o PNG. Consulta la sezione ImageObject (logo) per ulteriori dettagli ed esempi.
isFamilyFriendly	Obbligatorio	Booleano	Indica se questi contenuti sono adatti alle famiglie (ovvero, se i contenuti sono adatti a tutti i membri della famiglia, inclusi i bambini). I prodotti Google potrebbero utilizzare isFamilyFriendly per stabilire quali contenuti riprodurre. Il valore deve essere true o false.
inLanguage	Obbligatorio	Testo	La lingua dei contenuti del podcast in formato ISO 639-1. Questo valore può essere utilizzato per rispondere alle 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'episodio finale della serie di podcast. Includi questo campo solo quando 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 i dettagli, consulta la sezione ActionAction.
popularityScore	Facoltativo	PopularityScoreSpecification	Un punteggio di popolarità per contribuire a determinare la priorità di pubblicazione quando sono presenti più candidati. Consulta la sezione PopularityScoreSpecification (popularityScore) per dettagli ed esempi.
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 serie di podcast. Ad esempio, nomi degli ospiti, argomenti trattati ecc.
sameAs	Facoltativo	URL	URL di una pagina web di riferimento di terze parti (non 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, la 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: In evidenza o Esclusivo	L'evento che segna la pubblicazione o l'uscita della serie di podcast. Un evento di pubblicazione potrebbe indicare la pubblicazione iniziale di un podcast da parte di un editore e i tipi più specializzati possono essere utilizzati per indicare l'esclusività o la caratteristica della pubblicazione. Per maggiori dettagli ed esempi, consulta la sezione PublicationEvent, messo in evidenza, esclusivo (releasedEvent). Contrassegnare una serie come esclusiva o in primo piano implica che tutte le puntate del programma siano esclusive o in primo piano.
countryOfOrigin	Facoltativo	Paese	Il paese degli uffici principali della società di produzione o del privato responsabile del podcast.

Specifica della puntata Podcast

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

Proprietà	Priorità	Tipo	Descrizione
@context	Obbligatorio	Testo	Contesto di schema.org. Imposta sempre su [http://schema.googleapis.com,{@language:xx}], dove xx è il codice della lingua. Imposta la lingua predefinita dei caratteri utilizzata per i valori di testo nel feed.
@type	Obbligatorio	Testo	Imposta sempre 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 corso del tempo. Viene trattato come una stringa opaca e non deve essere un link funzionante. La tua organizzazione deve essere proprietaria del dominio utilizzato per il valore @id.
url	Obbligatorio	Testo	L'URL canonico sul 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 aiutarti a riconciliare con precisione i contenuti nel tuo feed con i contenuti nei database di Google. Per la riproduzione, viene utilizzata la target.urlTemplate dettagliata 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 per più aree geografiche 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. Questo valore si riferisce spesso all'host. Se l'autore è lo stesso del programma, puoi riutilizzare le informazioni dell'entità PodcastSeries. Per esempi e dettagli, consulta la sezione Organizzazione, Persona (autore/editore).
publisher	Obbligatorio	Persona o organizzazione ripetuto	Il gruppo o la rete originali responsabili della pubblicazione del programma. Spesso si riferisce a un'organizzazione responsabile della pubblicazione o della produzione di diversi podcast. Consulta Organizzazione, Persona (autore/editore) per esempi e dettagli. Questo campo è altamente consigliato per la disambiguazione e ti consigliamo di definirlo ovunque sia applicabile.
actor	Obbligatorio	Persona o organizzazione ripetuto	Attore del podcast. Per esempi e dettagli, consulta la sezione Attore (organizzatore/ospite).
datePublished	Obbligatorio	Data/ora	Il timestamp della pubblicazione della puntata del podcast. Questo valore viene utilizzato per ordinare la sequenza e la disambiguazione della puntata.
episodeNumber	Obbligatorio	Numero intero	Il numero della puntata.
partOfSeries	Obbligatorio	Podcast	La PodcastSeries in cui si trova questa puntata del podcast. Consulta la pagina PodcastSeries(partOfSeries) per dettagli ed esempi.
partOfSeason	Facoltativo	Stagione podcast	Per le serie multi-stagione, questa proprietà fornisce le informazioni sulla stagione, oltre al numero e al nome della stagione. Consulta PodcastSeason(partOfSeason) per dettagli ed esempi.
timeRequired	Obbligatorio	Durata	La durata della puntata in formato ISO 8601.
image	Facoltativo	ImageObject ripetuto	Un'immagine della serie. Deve essere una descrizione completa ImageObject. Fornisci la risoluzione più alta disponibile. È preferibile usare il formato JPEG o PNG. Consulta la sezione ImageObject (logo) per dettagli ed esempi.
isFamilyFriendly	Obbligatorio	Booleano	Indica se i contenuti sono adatti a tutta la famiglia (ovvero se sono adatti a tutti i membri della famiglia, inclusi i bambini). I prodotti Google potrebbero usare i 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 in formato ISO 639-1. Utilizza questo valore per rispondere a query degli utenti che richiedono contenuti in una lingua specifica. Se i contenuti sono in più lingue, elenca solo una 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(associateMedia).
potentialAction	Obbligatorio	ListenAction	L'azione da attivare per consentire agli utenti di ascoltare i contenuti. Per maggiori dettagli, consulta la sezione AscoltaAction.
popularityScore	Facoltativo	Specifica del punteggio popolarità	Un punteggio di popolarità per determinare la priorità di pubblicazione quando ci sono più candidati. Per dettagli ed esempi, consulta la sezione PopolaritàScoreSpecificazione.
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 può identificare in modo univoco e univoco le puntate di un podcast. È diverso dal campo @id nella puntata. Consulta la sezione PropertyValue (identificatore) per un esempio.
sameAs	Facoltativo	URL	URL di una pagina web di riferimento di terze parti (non 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. Tenete presente che la pagina di riferimento a livello di serie non deve essere fornita qui. Ti consigliamo vivamente di compilare questo campo per distinguere la puntata.
releasedEvent	Facoltativo	PublicationEvent o sottotipi più specifici: In evidenza o EsclusiEvent	L'evento che segna la pubblicazione o la pubblicazione della puntata del podcast. Un evento di pubblicazione potrebbe indicare la pubblicazione iniziale di una puntata del podcast di un editore, mentre i sottotipi più specifici possono indicare l'esclusività o la caratteristica della pubblicazione. Per maggiori dettagli ed esempi, consulta la sezione PublicationEvent, PrincipalEvent, EsclusiEvent (releasedEvent). Contrassegnare una serie come esclusiva o in evidenza implica che tutte le puntate del programma sono esclusive o in primo piano. Ti consigliamo di contrassegnare queste proprietà al livello più dettagliato.
countryOfOrigin	Facoltativo	Paese	Il paese degli uffici 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 di Google per PodcastSeries è un sottotipo in CreativeWorkSeries e PodcastEpisode è un sottotipo in Episode. Se alcune proprietà puoi fornire, ma non sono incluse nelle tabelle precedenti, puoi comunque seguire la specifica di schema.org per includerle nel feed.

Ti consigliamo le seguenti proprietà: editor, accountablePerson, dateModified, copyrightHolder, discussionUrl, actor e director.

PodcastSeries (partOfSeries)

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

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre su PodcastSeries.
@id	Obbligatorio	URL	L'ID univoco globale per la serie in formato URI. L'ID deve corrispondere all'ID dell'entità PodcastSeries completa nel tuo feed.
name	Obbligatorio	Testo	Il nome della serie del podcast. Utilizza un array per eseguire il markup della descrizione in più lingue Consulta l'esempio 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 relative a una stagione di PodcastEpisode, soprattutto il numero della stagione. Questa proprietà è necessaria solo quando la serie di podcast ha più stagioni.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta 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 corso del tempo. Viene trattato come una stringa opaca e non deve 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: Confronto tra autore e editore

Nella maggior parte dei casi, author si riferisce al conduttore o all'autore della serie di podcast. Se gli host sono comunemente riconosciuti come gruppi anziché come singole persone, utilizza il tipo Organization e fornisci il nome del gruppo.

publisher è l'organizzazione editoriale o la persona del programma. Può coincidere con l'autore quando la serie di podcast viene pubblicata in modo indipendente oppure può rappresentare la rete nel caso in cui un'organizzazione pubblichi il podcast.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre 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 corso del tempo. Viene trattato 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 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. Gli esempi possono includere una pagina 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 (Ospite o ospite)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre 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 corso del tempo. Viene trattato 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 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. Gli esempi possono includere una pagina 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 la grafica dei contenuti.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre su ImageObject.
height	Facoltativo	Numero intero	Altezza dell'immagine in pixel.
width	Facoltativo	Numero intero	La larghezza dell'immagine, in pixel.
contentUrl	Obbligatorio	URL	Un URL in cui può trovarsi l'immagine.
regionsAllowed	Facoltativo	Paese ripetuto	I paesi in cui è consentita la pubblicazione di contenuti multimediali: Se non specificato, si presume che l'immagine sia consentita in tutti i paesi. Per inviare immagini diverse per area geografica, aggiungi più proprietà ImageObject, ciascuna con il proprio gruppo di paesi e un URL immagine corrispondente.

Paese (image.regionsAllowed)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta 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 al 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 dominio) e deve rappresentare la puntata di origine a livello globale e univoco nel tempo, tra origini.

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

Esempio 1

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

Popolarità punteggio popolarità (popolarità punteggio)

popularityScore può aiutare gli utenti a visualizzare i contenuti più appropriati, nei casi in cui i criteri della query dell'utente corrispondano a più entità del feed. I contenuti con il punteggio di popolarità più alto disponibile per la regione dell'utente vengono mostrati all'utente quando questo valore è disponibile. Per impostazione predefinita, tutti i contenuti senza questo campo ottengono il punteggio di popolarità: 0. Il confronto dei punteggi rientra nell'ambito del tuo catalogo completo, quindi assicurati che la scala sia coerente per tutti i tuoi feed.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre su PopularityScoreSpecification.
value	Obbligatorio	Numerico	Un valore numerico positivo da confrontare con altre entità del catalogo per la priorità di pubblicazione. Un numero maggiore rappresenta una maggiore popolarità.
eligibleRegion	Facoltativo	Paese o testo ripetuto	Una regione o un elenco delle regioni a cui si applica questo punteggio di popolarità. Se il punteggio di popolarità si applica a livello globale, utilizza earth come valore di testo. Se occorre elencare regioni specifiche, utilizza il tipo "Paese". Se non aggiungi questo campo, eligibleRegion sarà impostato su earth per impostazione predefinita.

Paese (popularityScore.EligibleRegion)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre 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, PrincipalEvent, EsclusiEvent (releasedEvent)

PublicationEvent

Usa questo oggetto per rappresentare la data e il luogo di pubblicazione di un programma o di una puntata (nota anche come "data di uscita" di una serie o puntata). Inoltre, il campo publishedBy indica l'entità di pubblicazione o distribuzione della serie o della puntata del podcast.

Evento esclusivo

Usa questo oggetto per indicare che il provider detiene diritti di distribuzione esclusivi per il podcast. L'esclusività può essere specifica per una determinata area geografica e avere limiti di tempo e deve includere il campo dell'organizzazione che rimanda al provider esclusivo dei contenuti.

Evento in primo piano

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

Originali è diverso da Esclusiva

Il termine "originale (in primo piano)" spesso indica i diritti esclusivi per una determinata entità, che sovraccaricano il termine. Pertanto, il significato previsto deve essere suddiviso nelle due categorie precedenti. È anche possibile che un'entità originale sia esclusiva e, in questo caso, releasedEvent può prendere un array con entrambi i tipi di eventi nella stessa entità.

Tieni presente che, sebbene l'esclusività o la caratteristica principale possano condividere significati simili all'interno del catalogo di un fornitore, PublicationEvent in genere si applica per consentire la disambiguazione delle entità e per fornire metadati aggiuntivi sullo stesso, come la data di uscita di una serie o puntata.

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre su PublicationEvent, ExclusiveEvent o FeaturedEvent.
location	Obbligatorio	Paese	La regione in cui si verifica l'evento di pubblicazione. Puoi anche utilizzarle per rappresentare le limitazioni di esclusività e distribuzione dell'entità. Utilizza i codici ISO 3166 per il paese. Se devi applicare la semantica globale, imposta su EARTH. Imposta in modo esplicito location su EARTH, nel caso in cui non siano applicabili restrizioni specifiche per le impostazioni internazionali.
startDate	Consigliato (obbligatorio per EventEvent)	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 caratteristica dell'entità.
endDate	Consigliato (obbligatorio per EventEvent)	Data o DateTime	Data di fine della pubblicazione delle entità. Nel caso di PublicationEvent, indica la data di pubblicazione finale di questa entità. Nel caso di ExclusiveEvent o FeaturedEvent, rappresenta la data di fine dell'esclusività o della caratteristica dell'entità.
publishedBy	Obbligatorio	Organizzazione o Persona	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 (associateMedia)

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

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre 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 del contenuto multimediale in formato di 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"
},

Ascolto (azione potenziale)

L'entità ListenAction definisce i link diretti per la riproduzione e i criteri che gli utenti possono utilizzare (ad esempio dati geografici, cronici, di accesso o di abbonamento) per accedere ai contenuti.

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

EntryPoint (potenzialeazione.target)

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

Testo

ripetuto

La piattaforma per cui è valido questo link diretto. 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 (PotenzialeAzione.ActionAccessibilityRequestment)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre 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 acquisto né accesso per accedere ai contenuti. free: l'azione è disponibile senza necessità di acquisto o di abbonamento a pagamento. L'azione richiede l'accesso di un utente. subscription: l'azione è inclusa nell'abbonamento a pagamento del tuo servizio.
availabilityStarts	Facoltativo	Data/ora	L'ora di inizio della finestra di disponibilità. Puoi utilizzarlo per controllare il momento esatto in cui questi contenuti possono essere esposti 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 vengono più mostrati agli utenti.
eligibleRegion	Obbligatorio	Paese ripetuto	Il paese idoneo per questa offerta. Puoi utilizzarlo per controllare il paese o la regione in cui questi contenuti devono essere disponibili.
requiresSubscription	Obbligatorio se applicabile	Abbonamento multimediale	Per accedere a questi contenuti è necessario il pacchetto di abbonamento. Se il 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 (PotenzialeAzione.ActionAccessibilityRequestment.IdoneoRegione)

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

MediaSubscription (forActionAction.actionAccessibilityRequestment.requestSubscription)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre su MediaSubscription.
@id	Obbligatorio	URL	Un ID univoco globale per il pacchetto di abbonamento in formato URI. L'ID deve essere stabile e non cambiare nel corso del tempo. Viene trattato come una stringa opaca e non deve 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 multimediale. Puoi utilizzare questo valore per esprimere il prezzo dell'abbonamento.

Offerta (forActionAction.actionAccessibilityRequestment.requestSubscription.expectsAcceptanceOf)

Proprietà	Priorità	Tipo	Descrizione
@type	Obbligatorio	Testo	Imposta sempre su Offer.
price	Obbligatorio	Numero	Il prezzo dell'abbonamento.
priceCurrency	Obbligatorio	Testo	La valuta (in formato ISO 4217) 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"
            }
        }
    ]
}