SportsEvents - Modellazione, best practice e feed di esempio

Definizione

Un SportsEvent è un tipo di entità che rappresenta un gioco di sport o la revisione completa di una partita di sport.

Cosa si può modellare come SportsEvent? Un gioco di sport
Cosa non può essere considerato un evento sportivo?

Qualsiasi video nel formato breve o clip o contenuti extra. Ecco l'elenco:

  • Riepiloghi casuali o riprodurre brevi clip
  • Anteprime del gioco
  • Momenti salienti del gioco
  • Gaffe
  • Clip di interviste con i giocatori
  • Video dei dietro le quinte
  • Recensioni dei giochi (generate dagli utenti o meno)
  • Brevi clip casuali del gioco

Come faccio a gestire questi contenuti extra?

Casi d'uso comuni degli eventi sportivi

N. di serie Descrizione Entità obbligatorie
Caso 1 Devo creare un modello SportsEvent che fa parte del mio catalogo di video on demand. SportsEvent che rappresenta il gioco.
Caso 2

Devo creare un modello SportsEvent che faccia parte del mio catalogo TV in diretta e dei miei stream online

Il gioco viene riprodotto in streaming su internet e non è collegato ad alcun canale.

SportsEvent che rappresenta il gioco.

BroadcastEvent che rappresenta la trasmissione della partita.
Caso 3 Devo creare un evento SportsEvent che faccia parte del mio catalogo di TV in diretta e che venga trasmesso online su un canale.

SportsEvent che rappresenta il gioco.

Broadcast che rappresenta la trasmissione del gioco.

Entità BroadcastService, Organization, TelevisionChannel e CableOrSatelliteService che rappresentano il canale e la selezione.
Caso 4 Combinazioni dei tre casi precedenti. Se combini un sottoinsieme dei casi d'uso precedenti, devi fornire i tipi di entità nella colonna "Entità obbligatorie" corrispondente.

Best practice e approfondimenti relativi ad alcuni controlli che effettuiamo

N. di serie Entità obbligatorie Linee guida
Caso 1

Devo creare un modello SportsEvent che fa parte del mio catalogo di video on demand.

Entità obbligatorie

  • SportsEvent che rappresenta il gioco

Linee guida per la definizione del modello

Il link diretto al gioco deve essere fornito nell'entità SportsEvent utilizzando la proprietà SportsEvent.PotentialAction.
Caso 2

Devo creare un modello SportsEvent che faccia parte del mio catalogo di TV in diretta e sia in streaming online.

Il gioco viene riprodotto in streaming su internet e non è collegato ad alcun canale.

Entità obbligatorie

  • SportsEvent che rappresenta il gioco
  • BroadcastEvent che rappresenta la trasmissione del gioco

Linee guida per la definizione del modello

Sottocaso 1: il gioco è disponibile solo dal vivo (e non fa parte del catalogo Video on demand)

  • Per condividere la programmazione della trasmissione è necessario fornire l'entità BroadcastEvent.
  • Il link diretto al gioco deve essere fornito nell'entità BroadcastEvent utilizzando la proprietà BroadcastEvent.potentialAction.
  • Poiché il gioco può essere visualizzato solo dal vivo, l'entità SportsEvent non deve avere link diretti. Ciò significa che non è necessario specificare l'elemento SportsEvent.potentialAction.
  • È necessario specificare BroadcastEvent.broadcastOfEvent perché la partita non è legata a nessun canale trasmesso.

Sottocaso 2: il gioco è disponibile dal vivo e fa parte del catalogo di video on demand (questo può accadere quando è in corso la trasmissione di una replica del gioco)

  • Per condividere la programmazione della trasmissione è necessario fornire l'entità BroadcastEvent.
  • Il link diretto al gioco deve essere fornito nell'entità BroadcastEvent utilizzando la proprietà BroadcastEvent.potentialAction.
  • Poiché il gioco può essere visualizzato dal vivo all'interno del catalogo di Video on demand, l'entità SportsEvent deve avere anche un link diretto. È necessario fornire SportsEvent.potentialAction per reindirizzare l'utente al catalogo di Video on demand.
  • BroadcastEvent.publishedOn non deve essere fornito perché la partita non è legata ad alcuna trasmissione di un canale.

Controlli di qualità per l'esecuzione

  • Imposta la proprietà BroadcastEvent.isLiveBroadcast su true quando il gioco è effettivamente pubblicato. Non impostare la proprietà su true per la riproduzione di una partita.
  • Per BroadcastEvents che non vengono pubblicati, il valore BroadcastEvent.startDate di solito non può essere precedente all'importo effettivo di SportsEvent startDate.
  • BroadcastEvents non deve avere una proprietà publishedOn perché la trasmissione viene trasmessa su internet e non si collega a un canale.
Caso 3

Devo creare un SportsEvent che faccia parte del mio catalogo TV in diretta e che venga trasmesso online su un canale.

Entità obbligatorie

  • SportsEvent che rappresenta il gioco.
  • BroadcastEvent, che rappresenta la trasmissione del gioco.
  • Entità BroadcastService, Organization, TelevisionChannel e CableOrSatelliteService che rappresentano il canale e la selezione.

Linee guida per la definizione del modello

Sottocaso 1: il gioco è disponibile solo dal vivo (e non fa parte del catalogo Video on demand)

  • Condividi il programma della trasmissione. Per farlo, fornisci l'entità BroadcastEvent.
  • Rappresenta il canale e la selezione di fornitori. Per farlo, fornisci le entità BroadcastService, Organization, TelevisionChannel e CableOrSatelliteService .
  • Fornisci il link diretto BroadcastService. Rappresentalo con la proprietà BroadcastService.potentialAction.
  • Non fornire la proprietà BroadcastEvent.potentialAction.
  • Poiché il gioco è disponibile solo per la visualizzazione dal vivo, l'entità SportsEvent non deve avere alcun link diretto. Ad esempio, non fornire SportsEvent.potentialAction.
  • Fornisci BroadcastEvent.publishedOn e indirizzalo all'entità BroadcastService che rappresenta il canale su cui verrà eseguita la trasmissione.

Sottocaso 2: il gioco è disponibile dal vivo e come parte del catalogo di Video on demand (questo può accadere quando è in corso la trasmissione di una riproduzione del gioco)

  • Fornisci l'entità BroadcastEvent per condividere il programma della trasmissione.
  • Fornisci le entità BroadcastService, Organization, TelevisionChannel e CableOrSatelliteService che rappresentano il canale e la selezione di fornitori.
  • Fornisci il link diretto BroadcastService al canale su cui verrà trasmessa la partita, rappresentato dalla proprietà BroadcastService.potentialAction.
  • Non fornire la proprietà BroadcastEvent.potentialAction.
  • Poiché il gioco può essere visualizzato dal vivo e all'interno del catalogo di Video on demand, l'entità SportsEvent deve anche avere un link diretto. Ad esempio, è possibile fornire SportsEvent.potentialAction che reindirizzi l'utente al catalogo Video on demand.
  • Fornisci BroadcastEvent.publishedOn e indirizzalo all'entità BroadcastService che rappresenta il canale su cui verrà eseguita la trasmissione.

Controlli di qualità per l'esecuzione

  • Imposta la proprietà BroadcastEvent.isLiveBroadcast su true quando il gioco è effettivamente pubblicato. Non impostare la proprietà su true per la riproduzione di una partita.
  • Per BroadcastEvents che non vengono pubblicati, il valore BroadcastEvent.startDate di solito non può essere precedente all'importo effettivo di SportsEvent startDate.
  • Dato che il gioco viene trasmesso su un canale, aggiungi un link diretto utilizzando la proprietà BroadcastService.potentialAction. In questo caso, l'entità BroadcastEvent non può avere un link diretto.

Esempi

Caso 1: un evento sportivo che fa parte del catalogo di video on demand


{
  "@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."
    },
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-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/pbl_semis_game?autoplay=true",
      "inLanguage": "en",
      "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/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-09-17T10:00-08:00",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
       },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Caso 2: un evento sportivo che fa parte del catalogo di programmi TV in diretta e viene trasmesso online

Evento di trasmissione


{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live_eevent/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B.",
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "False",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/pbl_semis_game?autoplay=true",
      "inLanguage": "en",
      "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/GoogleVideoCast"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "subscription",
      "availabilityStarts": "2018-09-16T10:00-08:00",
      "availabilityEnds": "2018-09-16T10:00-08:00",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  },
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  }
}

Evento sportivo


{
  "@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."
    },
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-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"
    }
  ]
}

Caso 3: un evento sportivo che fa parte del catalogo di TV in diretta e viene trasmesso online su un canale

Evento di trasmissione


{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live_eevent/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B.",
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": "False",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  }
}

Evento sportivo


{
  "@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."
    },
  "startDate": "2018-09-16T10:00-08:00",
  "endDate": "2018-09-16T13:00-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"
    }
  ]
}

entità BroadcastService, CableOrSatelliteService, TelevisionChannel, Organization come definite nella sezione Canale TV in diretta della sezione Concetti

Come faccio a gestire i contenuti extra?

Quali contenuti vengono considerati contenuti extra?
  • Riepiloghi casuali o riprodurre brevi clip
  • Anteprime del gioco
  • Momenti salienti del gioco
  • Gaffe
  • Clip di interviste con i giocatori
  • Video dei dietro le quinte
  • Recensioni dei giochi (generate dagli utenti o meno)
  • Altri brevi clip casuali del gioco
N. di serie Caso d'uso Linee guida per la definizione del modello
Caso 1 Nel mio catalogo di Video on demand sono presenti contenuti extra.
  • Non è supportato e non può essere fornito nel feed.
  • Tuttavia, ViTA può essere utilizzato per fornire un sottoinsieme di questi contenuti. Contatta il tuo rappresentante di Google per scoprire di più su ViTA.
Caso 2 Ho contenuti extra nel mio catalogo live

Sottocaso 1: i contenuti sono disponibili per lo streaming in diretta su internet

  • Fornisci l'entità BroadcastEvent per condividere il programma della trasmissione.
  • Fornisci il link diretto dei contenuti utilizzando la proprietà BroadcastEvent.potentialAction .
  • Aggiungi eventuali metadati associati (al clip) direttamente in BroadcastEvent . Ad esempio, puoi aggiungere immagini utilizzando la proprietà BroadcastEvent.image . Le classificazioni in base all'età possono essere aggiunte utilizzando la proprietà BroadcastEvent.contentRating .
  • Poiché questo tipo di contenuti non è un SportsEvent, il feed non deve contenere un'entità SportsEvent. Di conseguenza, la proprietà broadcastOfEvent nella pagina BroadcastEvent non deve essere fornita.
  • Poiché non è collegato a un canale, non fornire la proprietà publishedOn sulla BroadcastEvent.

Sottocaso 2: i contenuti possono essere trasmessi in live streaming su internet su un canale

  • Per condividere la programmazione della trasmissione è necessario fornire l'entità BroadcastEvent.
  • È necessario fornire le entità BroadcastService, Organization, TelevisionChannel e CableOrSatelliteService per rappresentare il canale e la selezione di fornitori.
  • Il link diretto al gioco deve essere semplicemente il link diretto BroadcastService , rappresentato dalla proprietà BroadcastService.potentialAction , che deve essere fornita.
  • La proprietà BroadcastEvent.potentialAction non deve essere fornita.
  • Tutti i metadati associati (al clip) devono essere aggiunti direttamente a BroadcastEvent. Ad esempio, le immagini possono essere aggiunte utilizzando la proprietà BroadcastEvent.image. Le classificazioni in base all'età possono essere aggiunte utilizzando la proprietà BroadcastEvent.contentRating.
  • Poiché questo tipo di contenuti non è un SportsEvent, il feed non deve contenere un'entità SportsEvent. Di conseguenza, la proprietà broadcastOfEvent nella pagina BroadcastEvent non deve essere fornita.
  • Poiché è collegato a un canale, fornisci la proprietà publishedOn su BroadcastEvent.
Caso 3 Dispongo di contenuti extra nell'ambito sia del catalogo di video on demand che del catalogo TV in diretta

Dato che al momento i contenuti extra sportivi di video on demand non sono accettati nel feed, questo è un caso simile al caso 2. Consulta le istruzioni a partire da questa pagina.

Domande frequenti

D: Dove posso trovare le specifiche associate alle entità menzionate in precedenza?

R. Qui puoi trovare le specifiche richieste.

Documentazione complessiva Collegamento
SportsEvent Collega
BroadcastService, Organization, TelevisionChannel e CableOrSatelliteService Collega
BroadcastEvent Collega

D: Esiste un documento più dettagliato che spiega come creare un modello per i canali TV in diretta e le selezioni?

R: Sì, puoi trovare maggiori dettagli nella sezione Canale TV in diretta in Concetti. Non esitare a richiedere l'accesso in visualizzazione se non riesci a visualizzare il documento.

D: ViTA supporta anche le partite in diretta complete e le repliche complete delle partite?

R: ViTA supporta i metadati relativi alle partite live integrali e alle repliche complete delle partite basate sul campionato (oltre a un sottoinsieme di contenuti extra)

  • Per i partner che hanno già un feed Azioni multimediali funzionante con Google o che dispongono di un'offerta Video on demand o in diretta TV, Google richiede che il feed si espanda e includa anche i tipi SportsEvent supportati.

    • Nel breve periodo, i partner possono utilizzare ViTA per l'importazione di contenuti extra. Tutti i tipi di contenuti supportati nel feed dovrebbero essere implementati nel lungo periodo.

  • ViTA è un'ottima opzione per i partner che non offrono video on demand o contenuti TV in diretta, ma che offrono solo sport basati sul campionato e contenuti extra correlati. Contatta il tuo rappresentante di Google per scoprire di più su ViTA.