Proprietà del markup dei contenuti degli eventi

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

Tabella delle specifiche di 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 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 dello show cambia). Verrà trattato come una stringa opaca e non deve necessariamente essere un link funzionante.
  • Sotto forma di Uniform Resource Identifier (URI)
  • Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.
Poiché l'url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'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 ogni lingua (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 questa è l'ora di inizio effettiva dell'evento, non quella 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 Consigliato vivamente 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 in inglese) dello sport.
homeTeam.sameAs URL Consigliato vivamente Perché? Un URL a una pagina web di riferimento che può identificare la squadra, ad esempio la pagina Wikipedia della squadra.
homeTeam.athlete Person Annotazione o 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 Consigliato vivamente Perché? Un URL a una pagina web di riferimento che può identificare il campionato della squadra, ad esempio la pagina di Wikipedia del campionato.
awayTeam SportsTeam Consigliato vivamente Perché? La squadra in trasferta dell'evento. Le proprietà sono le stesse di SportsEvent.homeTeam.
competitor SportsTeam o Person Consigliato vivamente 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 O Città Il luogo dell'evento.
location.name Testo Obbligatorio: il nome della località.
location.address PostalAddress Obbligatorio se location @type è Place: l'indirizzo della località. Questo valore non deve essere utilizzato se @type della località è City
location.address.streetAddress Testo L'indirizzo della sede.
location.address.addressLocality Testo La città della località.
location.address.addressRegion Testo Lo stato della località.
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: l'immagine o le immagini correlate all'evento. Consigliata come poster o banner ufficiale dell'evento. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere in 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 live, utilizza invece la proprietà publishedOn o potentialAction in BroadcastEvent.
identifier PropertyValue Consigliato vivamente Perché? - ID esterno o altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per i dettagli, consulta la sezione Proprietà identificatore.

Esempi di SportsEvent

Esempio di sport di squadra

{
  "@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 di sport individuali

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

SportsEvent con limitazioni GeoShape

{
  "@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"
    }
  ]
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          http://schema.googleapis.com/GoogleVideoCast
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "free",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
       "eligibleRegion": [{
          "@type": "GeoShape",
          "@id": "http://example.com/area1",
          "addressCountry": "US",
          "postalCode": [
            "94118",
            "94119"
            ]
          },
          {
          "@type": "GeoShape",
          "@id": "http://example.com/area2",
          "addressCountry": "US",
          "postalCode": [
            "94120",
            "94121"
            ]
          },
        ]
      }
    }
  ]
}

Tabella delle specifiche di MusicEvent

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 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
  • Statica
  • Sotto forma di Uniform Resource Identifier (URI)
Poiché l'url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'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 ogni lingua (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 è l'autore di un'opera eseguita in occasione di un 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 conferenza include molte presentazioni, ognuna delle quali è un subEvent della conferenza.
superEvent Evento Un evento di cui fa parte questo evento. Ad esempio, una raccolta di esibizioni musicali individuali potrebbe avere un festival musicale come superEvento.
location Luogo O Città Obbligatorio: il luogo dell'evento.
location.name Testo Obbligatorio: il nome della località.
location.address PostalAddress Obbligatorio se location @type è Place: l'indirizzo della località. Questo campo non deve essere utilizzato se @type della località è City.
location.address.streetAddress Testo L'indirizzo della sede.
location.address.addressLocality Testo La città della località.
location.address.addressRegion Testo Lo stato della località.
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 una rappresentazione teatrale in un 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: sempre impostato su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel 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
  • Statica
  • Sotto forma di Uniform Resource Identifier (URI)
Poiché l'url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'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 ogni lingua (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 conferenza include molte presentazioni, ognuna delle quali è un subEvent della conferenza.
superEvent Evento Un evento di cui fa parte questo evento. Ad esempio, una raccolta di esibizioni musicali individuali potrebbe avere un festival musicale come superEvento.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Consigliato vivamente Perché? - Un PublicationEvent viene utilizzato per specificare la pubblicazione originale (globale o locale) dei contenuti da parte di un editore, ad esempio la data di uscita cinematografica originale di un film.

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

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

Per dettagli ed esempi, consulta la sezione Esempio.
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 a questo evento.

Per un PublicationEvent, questa è la regione in cui sono stati pubblicati i contenuti.

Per FeaturedEvent e ExclusiveEvent, questa è la regione in cui i contenuti sono in evidenza o esclusivi.

Utilizza i codici ISO 3166 per i paesi. Per indicare ovunque nel mondo, imposta EARTH.
releasedEvent.startDate Date o DateTime Consigliato: obbligatorio per ExclusiveEvent. La data di inizio della pubblicazione dell'entità.

Per un PublicationEvent, indica la data di uscita iniziale dell'entità, ad esempio la data di uscita di un film nelle sale cinematografiche.

Per ExclusiveEvent e FeaturedEvent, rappresenta la data di inizio dell'esclusività o della messa in evidenza dell'entità.
releasedEvent.endDate Date o DateTime Consigliato - Obbligatorio per ExclusiveEvent - Questo valore è applicabile 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 mette in evidenza l'entità.

Se i contenuti sono in esclusiva o in evidenza perpetua, imposta endDate su 20 anni dalla data attuale.
releasedEvent.publishedBy Organization o Person (Facoltativo) L'organizzazione o la persona che ha pubblicato questa entità.
location Luogo O Città Obbligatorio: il luogo dell'evento. Tieni presente che puoi fornire Place a livello di City.
location.name Testo Obbligatorio: il nome della località.
location.address PostalAddress Obbligatorio se location @type è Place: l'indirizzo della località. Questo campo non deve essere utilizzato se @type della località è Città
location.address.streetAddress Testo L'indirizzo della sede.
location.address.addressLocality Testo La città della località.
location.address.addressRegion Testo Lo stato della località.
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 una rappresentazione teatrale in un 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"
  }
}