Proprietà di markup dei contenuti degli eventi TV in diretta

Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per il tipo di entità BroadcastEvent. Per comprendere meglio la relazione tra questi tipi, consulta i concetti relativi agli eventi di Live TV.

Tabella delle specifiche di BroadcastEvent

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 BroadcastEvent.
@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 titolo del programma o dell'evento.
description Testo La descrizione del programma o dell'evento. Limite di 300 caratteri. Utilizza un array per includere le descrizioni in più lingue e lunghezze.
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.
publishedOn BroadcastService Obbligatorio se applicabile: specifica l'entità BroadcastService che trasmette il programma o l'evento.

Se i contenuti vengono trasmessi su un canale TV, questa proprietà è obbligatoria. Se i contenuti non sono associati a nessun canale TV, non fornire questa proprietà.
publishedOn.@type Testo Da impostare su BroadcastService.
publishedOn.@id URL Il @id dell'entità BroadcastService che trasmette questo programma o evento.
workPerformed CreativeWork Obbligatorio se applicabile: utilizza questa proprietà quando i contenuti sono uno dei seguenti tipi di entità: Movie, TVSeries e TVEpisode.
È vivamente consigliato che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced impostato su true
  • offAir impostato su true
workPerformed.@type Testo Impostato su Movie, TVSeries o TVEpisode.
workPerformed.@id URL L'@id dell'entità di contenuti.
broadcastOfEvent SportsEvent Obbligatorio se applicabile:utilizza questa proprietà se i contenuti sono un evento dal vivo.
  • Per un evento sportivo, questa proprietà deve fare riferimento a un'entità SportsEvent.

È vivamente consigliato che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced impostato su true
  • offAir impostato su true
broadcastOfEvent.@type Testo Da impostare su SportsEvent.
broadcastOfEvent.@id URL Il @id dell'entità evento. L'entità evento deve esistere nel feed e avere un valore @id diverso da quello di BroadcastEvent.
location Testo o Paese Obbligatorio se BroadcastEvent è per un evento sportivo, ovvero se ha la proprietà broadcastOfEvent: il paese in cui può essere trasmesso l'evento sportivo sottostante. Questo campo può essere un elenco di paesi se più paesi possono trasmettere l'evento sportivo.
videoFormat Testo La definizione di qualità più elevata supportata su questo servizio di trasmissione; ad esempio,
  • "SD" per definizione standard.
  • "HD" per alta definizione.
  • "2K" per la risoluzione 2K.
  • "4K" per la risoluzione 4K.
  • "8K" per la risoluzione 8K.
contentToBeAnnounced Valore booleano Obbligatorio se applicabile: utilizza questa proprietà se i contenuti sono sconosciuti al momento della creazione del feed.

Imposta su true quando il fornitore non dispone di informazioni aggiornate su ciò che verrà trasmesso, su false in caso contrario.
È vivamente consigliato che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced impostato su true
  • offAir impostato su true
offAir Valore booleano Obbligatorio se applicabile: utilizza questa proprietà se non sono previsti contenuti pianificati per la fascia oraria.
È vivamente consigliato che un'entità BroadcastEvent includa almeno uno dei seguenti elementi:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced impostato su true
  • offAir impostato su true
isLiveBroadcast Valore booleano Impostato su true se si tratta di un evento dal vivo, ad esempio un evento sportivo o un concerto.
potentialAction WatchAction Obbligatorio se applicabile: se i contenuti vengono trasmessi come evento in live streaming senza canale (con contentToBeAnnounced impostato su false o offAir impostato su false) , utilizza questa proprietà per fornire il link diretto dell'evento.
identifier PropertyValue ID esterno che identifica i contenuti trasmessi. Per maggiori dettagli, consulta la sezione Proprietà degli identificatori.
  • Nota: il tipo di entità BroadcastEvent accetta solo valori propertyID di TMS_ID o TMS_ROOT_ID.
  • Questa proprietà deve essere fornita solo nei casi in cui non viene fatto riferimento a un'entità Movie, TVSeries, TVEpisode o SportsEvent di primo livello completamente formata utilizzando la proprietà workPerformed o broadcastOfEvent.
  • Il valore della proprietà deve riflettere TMS_ID o TMS_ROOT_ID dell'entità Movie, TVSeries, TVEpisode o SportsEvent a cui faresti idealmente riferimento utilizzando la proprietà workPerformed o broadcastOfEvent.
  • È preferibile utilizzare TMS_ID rispetto al valore TMS_ROOT_ID.
contentRating Testo o Valutazione Obbligatorio per i contenuti per adulti, vivamente consigliato in caso contrario Perché? - Classificazione complessiva dei contenuti della trasmissione. Se la classificazione dei contenuti è fornita sotto forma di stringa di testo, sono accettate due varianti:
  • L'agenzia di rating ha anteposto la valutazione con uno spazio vuoto in mezzo. Ad esempio, una classificazione "PG-13" dell'agenzia "MPAA" negli Stati Uniti deve essere descritta come "MPAA PG-13". Consulta l'elenco delle agenzie.
  • Un valore "RATING NOT KNOWN" (senza distinzione tra maiuscole e minuscole) per indicare che non conosci la classificazione del film.
contentRating.author Organizzazione Obbligatorio se contentRating utilizza Rating: il nome dell'agenzia di classificazione.
contentRating.ratingValue Testo Obbligatorio se contentRating utilizza Rating: il valore della classificazione.
contentRating.advisoryCode Testo Il codice di avviso per i contenuti. I valori accettati sono D, FV, L, S e V. D = Dialoghi, FV = Violenza fantastica, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza.

Esempi

Il 12 ottobre 2019, una puntata TV viene trasmessa dall'emittente Example TV (BroadcastService) tra le 21:00 e le 21:30:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
  "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "description": "Three mice leave the town and the trip turns into something more.",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
  }
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Esempio che mostra l'utilizzo della proprietà contentToBeAnnounced quando i contenuti da trasmettere sulla rete televisiva Example TV (BroadcastService) tra le 21:00 e le 21:30 del 12 ottobre 2019 non sono noti al momento della creazione del feed:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "To Be Announced"
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "contentToBeAnnounced": true
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Il canale della rete televisiva Example TV(BroadcastService) non è trasmesso tra le 12:00 e le 20:00 e trasmette un programma denominato My favorite show tra le 20:00 e le 12:00:

BroadcastEvent 

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "BroadcastEvent",
   "@id": "http://example.com/randomUniqueEventId1",
   "name": “Off Air”,
   "startDate": "2019-10-12T00:00-08:00",
   "endDate": "2019-10-12T20:00-08:00",
   "publishedOn": {
       "@type": "BroadcastService",
       "@id": "http://example.com/stations/example_tv"
   },
   "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId2",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "name": "My favorite show",
  "workPerformed": {
    ...
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },

}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Consulta le seguenti pagine per gli argomenti relativi a queste proprietà: