Proprietà del markup dei contenuti degli eventi

Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per il tipo di entità correlato a Event.

Tabella delle specifiche di SportsEvent

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: impostato sempre su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel formato BCP 47, ad esempio "it".
@type Testo Obbligatorio: impostato sempre su SportsEvent.
@id URL Obbligatorio: l'identificatore dei contenuti in formato URI, ad esempio https://example.com/1234abc.
@id deve soddisfare i seguenti requisiti:
  • Univoco a livello globale nel tuo catalogo
  • Statico: l'ID deve 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 URI (Uniform Resource Identifier)
  • Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.
Poiché il url di un'entità soddisfa tutti i requisiti di un identificatore, ti consigliamo di utilizzare il url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore.
name Testo Obbligatorio: il nome dell'evento.
  • Utilizza un array per elencare i nomi in lingue diverse. Consulta l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per impostazioni internazionali (coppia lingua-paese).
description Testo La descrizione di questo evento. Limite di 300 caratteri. Utilizza un array per includere le descrizioni in più lingue e lunghezze.
sport URL Obbligatorio Un link alla pagina di Wikipedia (preferibilmente in inglese) dello sport.
startDate DateTime o Date Obbligatorio: l'ora di inizio dell'evento nel formato ISO 8601 con il fuso orario. Tieni presente che si tratta dell'ora di inizio effettiva dell'evento, non dell'ora in cui viene trasmesso in TV.
endDate DateTime o Date L'ora di fine dell'evento nel formato ISO 8601 con il fuso orario.
homeTeam SportsTeam Molto consigliato Perché? La squadra di casa dell'evento.
homeTeam.name Testo Obbligatorio Il nome completo della squadra.
homeTeam.sport URL Obbligatorio Un link alla pagina di Wikipedia (preferibilmente in inglese) dello sport.
homeTeam.sameAs URL Molto consigliato Perché? Un URL a una pagina web di riferimento che può identificare la squadra, ad esempio la pagina di Wikipedia della squadra.
homeTeam.athlete Person Annotazioni per un singolo atleta della squadra.
homeTeam.athlete.name Testo Il nome completo dell'atleta.
homeTeam.parentOrganization.name SportsOrganization Obbligatorio Il nome del campionato di cui fa parte la squadra. Ad esempio, National Basketball Association o Major League Baseball. Tieni presente che questo campo non deve essere utilizzato per la conferenza del team.
homeTeam.parentOrganization.sameAs URL Molto consigliato Perché? L'URL di una pagina web di riferimento che può identificare il campionato della squadra, ad esempio la pagina di Wikipedia del campionato.
awayTeam SportsTeam Molto consigliato Perché? La squadra in trasferta dell'evento. Le proprietà sono le stesse di SportsEvent.homeTeam.
competitor SportsTeam o Person Molto consigliato Perché? Se la squadra di casa o in trasferta non è applicabile (ad es. un incontro di pugilato, le Olimpiadi), specifica i partecipanti come concorrenti. Se SportsTeam, le proprietà sono le stesse di SportsEvent.homeTeam. Se Person, le proprietà sono le stesse degli altri oggetti Person, ad esempio un attore in Movie.
location Luogo OPPURE Città Il luogo dell'evento.
location.name Testo Obbligatorio: il nome della stazione di ricarica.
location.address PostalAddress Obbligatorio se @type della località è Luogo: l'indirizzo della località. Questo valore non deve essere utilizzato se la posizione @type è Città
location.address.streetAddress Testo L'indirizzo della stazione di ricarica.
location.address.addressLocality Testo La città della località.
location.address.addressRegion Testo Lo stato della stazione di ricarica.
location.address.postalCode Testo Il codice postale della località.
location.address.addressCountry Testo I paesi in formato ISO 3166.
image ImageObject Obbligatorio per Google TV: le immagini relative all'evento. Consigliato: poster o banner ufficiale dell'evento. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere con image, consulta Proprietà immagine.
potentialAction WatchAction Obbligatorio se applicabile: il link diretto che riproduce la registrazione di questo evento sportivo su Video on Demand. Per specificare il link diretto per un evento dal vivo, utilizza invece la proprietà publishedOn o potentialAction in BroadcastEvent.
identifier PropertyValue Molto consigliato Perché? - ID esterno o un altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per maggiori dettagli, consulta la sezione Proprietà identificatore.

Esempi di SportsEvent

Esempio 1 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

Esempio 2 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "sport":"https://en.wikipedia.org/wiki/Boxing"
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

Tabella delle specifiche di MusicEvent

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: impostato sempre su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel formato BCP 47, ad esempio "it".
@type Testo Obbligatorio: impostato sempre su MusicEvent.
@id URL Obbligatorio: l'identificatore dei contenuti in formato URI, ad esempio https://example.com/1234abc.
@id deve soddisfare i seguenti requisiti:
  • Univoco a livello globale nel tuo catalogo
  • Statica
  • Sotto forma di URI (Uniform Resource Identifier)
Poiché il url di un'entità soddisfa tutti i requisiti di un identificatore, ti consigliamo di utilizzare il url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore.
name Testo Obbligatorio: il nome dell'evento.
  • Utilizza un array per elencare i nomi in lingue diverse. Consulta l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per impostazioni internazionali (coppia lingua-paese).
description Testo La descrizione dell'evento. Limite di 300 caratteri. Utilizza un array per includere le descrizioni in più lingue e lunghezze.
attendee Organization o Person Una persona o un'organizzazione che partecipa all'evento.
startDate Data Obbligatorio: l'ora di inizio dell'evento nel formato ISO 8601 con il fuso orario.
endDate Data L'ora di fine dell'evento nel formato ISO 8601 con il fuso orario.
composer Organization o Person La persona o l'organizzazione che ha scritto una composizione o che è il compositore di un'opera eseguita in qualche evento.
performer Organization o Person Obbligatorio: un artista che si esibisce all'evento, ad esempio un presentatore, un musicista, un gruppo musicale o un attore.
subEvent Evento Un evento che fa parte di questo evento. Ad esempio, un evento di una conferenza include molte presentazioni, ognuna delle quali è un evento secondario della conferenza.
superEvent Evento Un evento di cui fa parte questo evento. Ad esempio, una raccolta di singole esibizioni musicali potrebbe avere come superEvent un festival musicale.
location Luogo OPPURE Città Obbligatorio: la località dell'evento.
location.name Testo Obbligatorio: il nome della stazione di ricarica.
location.address PostalAddress Obbligatorio se @type della località è Luogo: l'indirizzo della località. Questo valore non deve essere utilizzato se @type della località è City.
location.address.streetAddress Testo L'indirizzo della stazione di ricarica.
location.address.addressLocality Testo La città della località.
location.address.addressRegion Testo Lo stato della stazione di ricarica.
location.address.postalCode Testo Il codice postale della località.
location.address.addressCountry Testo I paesi in formato ISO 3166.
workPerformed CreativeWork Un'opera eseguita in qualche evento, ad esempio una rappresentazione teatrale in un evento TheaterEvent.

Esempio di MusicEvent

MusicEvent 

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

Tabella delle specifiche degli eventi

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: impostato sempre su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel formato BCP 47, ad esempio "it".
@type Testo Obbligatorio: impostato sempre su Event.
@id URL Obbligatorio: l'identificatore dei contenuti in formato URI, ad esempio https://example.com/1234abc.
@id deve soddisfare i seguenti requisiti:
  • Univoco a livello globale nel tuo catalogo
  • Statica
  • Sotto forma di URI (Uniform Resource Identifier)
Poiché il url di un'entità soddisfa tutti i requisiti di un identificatore, ti consigliamo di utilizzare il url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore.
name Testo Obbligatorio: il nome dell'evento.
  • Utilizza un array per elencare i nomi in lingue diverse. Consulta l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per impostazioni internazionali (coppia lingua-paese).
description Testo La descrizione dell'evento. Limite di 300 caratteri. Utilizza un array per includere le descrizioni in più lingue e lunghezze.
attendee Organization o Person Una persona o un'organizzazione che partecipa all'evento.
startDate Data Obbligatorio: l'ora di inizio dell'evento nel formato ISO 8601 con il fuso orario.
endDate Data L'ora di fine dell'evento nel formato ISO 8601 con il fuso orario.
subEvent Evento Un evento che fa parte di questo evento. Ad esempio, un evento di una conferenza include molte presentazioni, ognuna delle quali è un evento secondario della conferenza.
superEvent Evento Un evento di cui fa parte questo evento. Ad esempio, una raccolta di singole esibizioni musicali potrebbe avere come superEvent un festival musicale.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Molto consigliato Perché? - Un PublicationEvent viene utilizzato per specificare la prima uscita (globale o locale) dei contenuti da parte di un editore, ad esempio la data di uscita originale nelle sale cinematografiche 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 degli esempi per dettagli ed esempi.
releasedEvent.@type Testo Obbligatorio: assicurati di impostare sempre questa proprietà su una delle seguenti:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Paese Obbligatorio: le regioni associate a questo evento.

Per un valore PublicationEvent, si tratta della regione in cui sono stati pubblicati i contenuti.

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 il valore EARTH.
releasedEvent.startDate Data o DateTime Consigliato - Obbligatorio per ExclusiveEvent: la data di inizio della pubblicazione della persona giuridica.

Per un PublicationEvent, indica la data di uscita iniziale della persona giuridica, ad esempio la data di prima uscita di un film nelle sale cinematografiche.

Per ExclusiveEvent e FeaturedEvent, indica la data di inizio in cui la persona giuridica è in 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 sui contenuti.

Per FeaturedEvent, rappresenta l'ultima data in cui il fornitore ha mostrato l'entità.

Se i contenuti sono permanentemente esclusivi o in primo piano, imposta endDate su 20 anni dalla data corrente.
releasedEvent.publishedBy Organization o Person Facoltativo: l'organizzazione o la persona che ha pubblicato questa entità.
location Luogo OPPURE Città Obbligatorio: la località dell'evento. Tieni presente che puoi fornire Place a livello City.
location.name Testo Obbligatorio: il nome della stazione di ricarica.
location.address PostalAddress Obbligatorio se @type della località è Luogo: l'indirizzo della località. Questo valore non deve essere utilizzato se l'attributo @type della posizione è City
location.address.streetAddress Testo L'indirizzo della stazione di ricarica.
location.address.addressLocality Testo La città della località.
location.address.addressRegion Testo Lo stato della stazione di ricarica.
location.address.postalCode Testo Il codice postale della località.
location.address.addressCountry Testo I paesi in formato ISO 3166.
workPerformed CreativeWork Un'opera eseguita in qualche evento, ad esempio una rappresentazione teatrale in un evento TheaterEvent.

Esempio di evento

Evento 

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}