Proprietà del markup dei contenuti degli eventi

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

Tabella delle specifiche SportsEvent

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: sempre impostato su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel formato formato BCP 47, ad esempio "en".
@type Testo Obbligatorio: sempre impostato 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 (Unified 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 come 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 diverse lingue. Vedi l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per ogni lingua (coppia lingua-paese).
description Testo La descrizione dell'evento. Limista 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 la versione in inglese) dello sport.
startDate DateTime o Date Obbligatorio: l'ora di inizio dell'evento nel formato ISO 8601 con fuso orario. Tieni presente che si tratta dell'ora di inizio effettiva dell'evento, anziché di quello in cui l'evento viene trasmesso in TV.
endDate DateTime o Date L'ora di fine dell'evento nel formato ISO 8601 e il fuso orario.
homeTeam SportsTeam vivamente consigliato Perché? La squadra di casa dell'evento.
homeTeam.name Testo Obbligatorio Il nome completo della squadra sportiva.
homeTeam.sport URL Obbligatorio Un link alla pagina di Wikipedia (preferibilmente la versione in inglese) dello sport.
homeTeam.sameAs URL vivamente consigliato Perché? Un URL a una pagina web di riferimento in grado di identificare il team, ad esempio la pagina di Wikipedia del team.
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 sportivo 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 vivamente consigliato Perché? Un URL che rimanda a una pagina web di riferimento che possa identificare il campionato della squadra, ad esempio la pagina del campionato di Wikipedia.
awayTeam SportsTeam vivamente consigliato Perché? La squadra di ricognizione dell'evento. Le proprietà sono uguali a SportsEvent.homeTeam.
competitor SportsTeam o Person vivamente consigliato Perché? Se la squadra di casa o di trasferta non è applicabile (ad esempio, una partita di boxe, 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 oggettiPerson; ad esempio, un attore in Movie.
location Luogo O Città Il luogo dell'evento.
location.name Testo Obbligatorio: il nome del luogo.
location.address PostalAddress Obbligatorio se località @tipo è Place: l'indirizzo della località. Non deve essere utilizzato se località @type è Città
location.address.streetAddress Testo L'indirizzo della sede dell'attività.
location.address.addressLocality Testo La città del luogo.
location.address.addressRegion Testo Lo stato del luogo.
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 correlate all'evento. È consigliabile che sia la locandina o il banner ufficiale dell'evento. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere con image, consulta Proprietà delle immagini.
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, usa invece la proprietà publishedOn o potentialAction in BroadcastEvent.
identifier PropertyValue vivamente consigliato Perché? - ID esterno o di altro tipo che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per maggiori dettagli, consulta la sezione Proprietà degli identificatori.

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 dell'evento musicale

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: sempre impostato su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel formato formato BCP 47, ad esempio "en".
@type Testo Obbligatorio: sempre impostato 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
  • Statiche
  • Sotto forma di URI (Unified Resource Identifier)
Poiché il url di un'entità soddisfa tutti i requisiti come 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 diverse lingue. Vedi l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per ogni lingua (coppia lingua-paese).
description Testo La descrizione dell'evento. Limista di 300 caratteri. Utilizza un array per includere le descrizioni in più lingue e lunghezze.
attendee Organizzazione o Persona Una persona o un'organizzazione che partecipa all'evento.
startDate Data Obbligatorio: l'ora di inizio dell'evento nel formato ISO 8601 con fuso orario.
endDate Data L'ora di fine dell'evento nel formato ISO 8601 e il fuso orario.
composer Organizzazione o Persona La persona o l'organizzazione che ha scritto una composizione o che è il compositore di un'opera eseguita a un evento.
performer Organizzazione o Persona Obbligatorio: un artista dell'evento, ad esempio un presentatore, un musicista, un gruppo musicale o un attore.
subEvent Eventi Un evento che fa parte di questo evento. Ad esempio, un evento conferenza include molte presentazioni, ognuna delle quali è un evento secondario della conferenza.
superEvent Eventi Un evento di cui fa parte l'evento. Ad esempio, una raccolta di singole esibizioni musicali potrebbe avere ciascuna un festival musicale come superevento.
location Luogo O Città Obbligatorio: il luogo dell'evento.
location.name Testo Obbligatorio: il nome del luogo.
location.address PostalAddress Obbligatorio se località @tipo è Place: l'indirizzo della località. Non deve essere utilizzato se località @type è Città.
location.address.streetAddress Testo L'indirizzo della sede dell'attività.
location.address.addressLocality Testo La città del luogo.
location.address.addressRegion Testo Lo stato del luogo.
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 un evento, ad esempio uno spettacolo teatrale eseguito in un evento Theater.

Esempio di evento musicale

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: sempre impostato su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel formato formato BCP 47, ad esempio "en".
@type Testo Obbligatorio: sempre impostato 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
  • Statiche
  • Sotto forma di URI (Unified Resource Identifier)
Poiché il url di un'entità soddisfa tutti i requisiti come 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 diverse lingue. Vedi l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per ogni lingua (coppia lingua-paese).
description Testo La descrizione dell'evento. Limista di 300 caratteri. Utilizza un array per includere le descrizioni in più lingue e lunghezze.
attendee Organizzazione o Persona Una persona o un'organizzazione che partecipa all'evento.
startDate Data Obbligatorio: l'ora di inizio dell'evento nel formato ISO 8601 con fuso orario.
endDate Data L'ora di fine dell'evento nel formato ISO 8601 e il fuso orario.
subEvent Eventi Un evento che fa parte di questo evento. Ad esempio, un evento conferenza include molte presentazioni, ognuna delle quali è un evento secondario della conferenza.
superEvent Eventi Un evento di cui fa parte l'evento. Ad esempio, una raccolta di singole esibizioni musicali potrebbe avere ciascuna un festival musicale come superevento.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent vivamente consigliato Perché? - Un PublicationEvent viene utilizzato per specificare l'uscita originale (globale o locale) dei contenuti di un editore, ad esempio la data di uscita nei cinema originali di un film.

Inoltre, utilizza FeaturedEvent per indicare che il tuo servizio commercializza questi contenuti come originali, in primo piano, speciali e così via.

ExclusiveEvent specifica che il tuo servizio gode di diritti di distribuzione esclusivi e include dove e quando.

Consulta la sezione esempi per dettagli ed esempi.
releasedEvent.@type Testo Obbligatorio - Assicurati di impostare sempre questa proprietà su uno dei seguenti valori:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Paese Obbligatorio: le regioni associate all'evento.

Per 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 l'opzione su EARTH.
releasedEvent.startDate Date o DateTime Consigliato - Obbligatorio per ExclusiveEvent: la data di inizio della pubblicazione dell'entità.

Per PublicationEvent, indica la data di uscita iniziale dell'entità, ad esempio la data in cui un film è uscito nei cinema.

Per ExclusiveEvent e FeaturedEvent, rappresenta la data di inizio in cui l'entità è in esclusiva o in primo piano.
releasedEvent.endDate Date 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 include l'entità.

Se i contenuti sono sempre esclusivi o in primo piano, imposta endDate su 20 anni dalla data corrente.
releasedEvent.publishedBy Organizzazione o Persona Facoltativo: l'organizzazione o la persona che ha pubblicato l'entità.
location Luogo O Città Obbligatorio: il luogo dell'evento. Tieni presente che puoi fornire Place nel livello City.
location.name Testo Obbligatorio: il nome del luogo.
location.address PostalAddress Obbligatorio se località @tipo è Place: l'indirizzo della località. Non deve essere utilizzato se località @type è Città
location.address.streetAddress Testo L'indirizzo della sede dell'attività.
location.address.addressLocality Testo La città del luogo.
location.address.addressRegion Testo Lo stato del luogo.
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 un evento, ad esempio uno spettacolo teatrale eseguito in un evento Theater.

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"
  }
}