Proprietà del markup dei contenuti degli eventi

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

Tabella delle specifiche di SportsEvent

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: imposta sempre su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel formato BCP 47, ad esempio "en".
@type Testo Obbligatorio: imposta 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 (e distinto dal valore @id di qualsiasi BroadcastEvent che fa riferimento a questo SportsEvent)
  • Statico: l'ID deve essere stabile e non cambiare nel tempo. Verrà trattato come una stringa opaca e non deve 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.
Importante: non includere una proprietà url in SportsEvent o BroadcastEvent. Fornisci i link di riproduzione utilizzando SportsEvent.potentialAction. 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 descrizioni in più lingue (una per lingua).
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 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 Consigliata: l'ora di fine programmata dell'evento nel formato ISO 8601 con fuso orario. Fornisci l'ora di fine programmata, se nota; se l'ora di fine non è nota, ometti questa proprietà anziché fornire un segnaposto stimato.
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 di 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 SportsOrganization Obbligatorio: il campionato sportivo o l'organizzazione di riferimento a cui appartiene la squadra. Includi parentOrganization sia su homeTeam che su awayTeam quando vengono fornite entrambe le squadre.
homeTeam.parentOrganization.name Testo 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 link alla pagina di Wikipedia (preferibilmente la versione in inglese) che identifica il campionato della squadra (ad esempio, https://en.wikipedia.org/wiki/National_Basketball_Association). Non utilizzare URL segnaposto example.com.
awayTeam SportsTeam Vivamente consigliato Perché? - La squadra ospite dell'evento. Le proprietà e i requisiti (incluso parentOrganization) sono gli stessi di SportsEvent.homeTeam.
competitor SportsTeam o Person Vivamente consigliato Perché? Se la squadra di casa o in trasferta non è applicabile (ad es. un incontro 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 di 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 @type della località è Place: l'indirizzo della località. Questo campo non deve essere utilizzato se @type della località è City
location.address.streetAddress Testo La via della località.
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 nel formato ISO 3166.
image ImageObject Obbligatorio per Google TV: le immagini relative all'evento. Consigliamo di utilizzare il poster o il banner ufficiale dell'evento. Per ulteriori dettagli sulle proprietà obbligatorie e facoltative da includere con image, consulta Proprietà immagine.
potentialAction WatchAction Obbligatorio se applicabile: deep link per riprodurre l'evento sportivo, utilizzato sia per i live streaming senza canali sia per i replay di video on demand. Tutti i deep link degli eventi sportivi devono trovarsi su SportsEvent.potentialAction; non inserire mai potentialAction su un BroadcastEvent che fa riferimento a un SportsEvent (per le trasmissioni di canali TV lineari senza un deep link diretto all'evento, fornisci il deep link del canale su BroadcastService.potentialAction). Fornisci un array di oggetti WatchAction quando offri più stream (ad esempio feed regionali, in casa o in trasferta o trasmissioni multilingue) o finestre di riproduzione live e video on demand separate.
potentialAction.actionAccessibilityRequirement ActionAccessSpecification Obbligatorio se viene fornito potentialAction: definisce il diritto e la finestra di disponibilità cliccabile (availabilityStarts e availabilityEnds) per ogni WatchAction:
  • Finestra pre-roll (availabilityStarts): per le trasmissioni sportive in diretta, imposta availabilityStarts almeno 14 giorni prima di SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) in modo che i riquadri degli eventi imminenti possano essere visualizzati in anticipo (l'entità dell'evento stessa può essere pubblicata più vicino al giorno della partita, purché il timestamp availabilityStarts sia almeno 14 giorni prima di startDate).
  • Buffer per i tempi supplementari (availabilityEnds): imposta availabilityEnds dopo SportsEvent.endDate con un buffer di almeno 2-3 ore (availabilityEnds >= SportsEvent.endDate + 2 to 3 hours o fino alla fine della finestra di riproduzione del video on demand) per evitare che i deep link scadano durante i tempi supplementari in diretta o la copertura post-partita.
Per informazioni dettagliate, consulta Proprietà di markup delle azioni.
identifier PropertyValue Vivamente consigliato Perché? - ID esterno o altro ID che identifica in modo univoco questa entità. Sono consentiti più identificatori. Per i dettagli, consulta la sezione Proprietà degli identificatori.

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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ]
}

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",
  "endDate": "2019-07-12T23:30-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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?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-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform"
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "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: imposta sempre su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel formato BCP 47, ad esempio "en".
@type Testo Obbligatorio: imposta 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
  • Statico
  • Sotto forma di URI (Unified Resource Identifier)
Poiché la url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare la 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 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 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 singole esibizioni musicali potrebbe avere un festival musicale come superEvent.
location Luogo O Città Obbligatorio: il luogo dell'evento.
location.name Testo Obbligatorio: il nome della località.
location.address PostalAddress Obbligatorio se @type della località è Place: l'indirizzo della località. Non deve essere utilizzato se @type della località è City.
location.address.streetAddress Testo La via della località.
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 nel formato ISO 3166.
workPerformed CreativeWork Un'opera rappresentata 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: imposta sempre su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità nel formato BCP 47, ad esempio "en".
@type Testo Obbligatorio: imposta 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
  • Statico
  • Sotto forma di URI (Unified Resource Identifier)
Poiché l'elemento url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare l'elemento 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 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 singole esibizioni musicali potrebbe avere un festival musicale come superEvent.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Vivamente consigliato Perché? - Un PublicationEvent viene utilizzato per specificare l'uscita originale (globale o locale) dei contenuti da parte di un publisher, ad esempio la data di uscita originale di un film nelle sale.

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.

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

Per un 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 su 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 di questa entità, ad esempio la data in cui un film è stato proiettato per la prima volta nelle sale.

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

Se i contenuti sono in esclusiva o in evidenza per sempre, 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 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 @type della località è Place: l'indirizzo della località. Questo campo non deve essere utilizzato se il valore @type della località è City
location.address.streetAddress Testo La via della località.
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 nel formato ISO 3166.
workPerformed CreativeWork Un'opera rappresentata 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"
  }
}