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 LiveTV.

Tabella delle specifiche di BroadcastEvent

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 BroadcastEvent.
@id URL Obbligatorio: l'identificatore dello slot di trasmissione in formato URI, ad esempio https://example.com/live/channel1/20191012T2100.
@id deve soddisfare i seguenti requisiti:
  • Univoco a livello globale nel tuo catalogo e distinto da workPerformed.@id o broadcastOfEvent.@id (ad esempio, incorpora il canale/servizio e l'ora di inizio della trasmissione nell'URI)
  • 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 BroadcastEvent o SportsEvent. Fornisci l'URL canonico url solo nell'entità dei contenuti sottostante (Movie, TVSeries o TVEpisode). Per maggiori dettagli, consulta la sezione Identificatore.
name Testo Obbligatorio: il titolo del programma o dell'evento.
description Testo La descrizione dello spettacolo o dell'evento. Limite di 300 caratteri. Utilizza un array per includere descrizioni in più lingue (una per lingua).
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.
publishedOn BroadcastService Obbligatorio se applicabile: specifica l'entità BroadcastService che trasmette questo programma o evento.

Se i contenuti vengono trasmessi su un canale TV, questa proprietà è obbligatoria. Se i contenuti non sono associati ad alcun canale TV, non fornire questa proprietà.
publishedOn.@type Testo Da impostare su BroadcastService.
publishedOn.@id URL La proprietà @id dell'entità BroadcastService che trasmette questo programma o evento.
workPerformed CreativeWork Obbligatoria se applicabile: utilizza questa proprietà quando i contenuti sono uno dei seguenti tipi di entità: Movie, TVSeries e TVEpisode.
Ti consigliamo vivamente di includere in un'entità BroadcastEvent almeno uno dei seguenti elementi:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced impostato su true
  • offAir impostato su true
workPerformed.@type Testo Da impostare su Movie, TVSeries o TVEpisode.
workPerformed.@id URL La proprietà @id dell'entità dei contenuti.
broadcastOfEvent SportsEvent Obbligatoria 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.

Ti consigliamo vivamente di includere almeno uno dei seguenti elementi in un'entità BroadcastEvent:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced impostato su true
  • offAir impostato su true
broadcastOfEvent.@type Testo Da impostare su SportsEvent.
broadcastOfEvent.@id URL Il @id dell'entità dell'evento. L'entità evento deve esistere nel feed e avere un @id diverso da quello di BroadcastEvent.
location Testo o Paese Obbligatorio se BroadcastEvent è per un SportsEvent, ovvero 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ù alta supportata su questo servizio di trasmissione, ad esempio
  • "SD" per la definizione standard.
  • "HD" per l'alta definizione.
  • "2K" per la risoluzione 2K.
  • "4K" per la risoluzione 4K.
  • "8K" per la risoluzione 8K.
contentToBeAnnounced Valore booleano Obbligatoria se applicabile: utilizza questa proprietà se i contenuti non sono noti al momento della creazione del feed.

Imposta su true quando il fornitore non dispone di informazioni aggiornate su ciò che verrà trasmesso, altrimenti su false.
Ti consigliamo vivamente di includere in un'entità BroadcastEvent almeno uno dei seguenti elementi:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced impostato su true
  • offAir impostato su true
offAir Valore booleano Obbligatorio se applicabile: imposta su true quando non è prevista la trasmissione di contenuti per la fascia oraria su un canale BroadcastService.
  • Imposta sia name che description su "Off Air".
  • Ogni offAir BroadcastEvent deve durare al massimo 4 ore (non trasmettere blocchi continui di 24 ore). Quando un canale non è in onda per più di 4 ore, genera più entità BroadcastEvent contigue e non sovrapposte di massimo 4 ore ciascuna, in modo che il canale mantenga una copertura completa della programmazione 24 ore su 24, 7 giorni su 7, senza interruzioni all'inizio o alla fine della finestra del feed.
È 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 Imposta il valore booleano true (senza virgolette) se questa trasmissione è una trasmissione live (ad esempio, una partita sportiva o un notiziario quotidiano in diretta) o false per la programmazione non live e le repliche.
potentialAction WatchAction Obbligatorio se applicabile - Non fornire mai potentialAction su un BroadcastEvent quando broadcastOfEvent fa riferimento a un SportsEvent (inserisci tutti i deep link sportivi su SportsEvent.potentialAction) o quando publishedOn fa riferimento a un canale BroadcastService (inserisci i deep link del canale su BroadcastService.potentialAction). Fornisci BroadcastEvent.potentialAction solo per i live streaming senza canale che non fanno riferimento a un SportsEvent (ad esempio contenuti extra live autonomi con contentToBeAnnounced e offAir omessi o false).
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 i 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 idealmente faresti riferimento utilizzando la proprietà workPerformed o broadcastOfEvent.
  • TMS_ID è preferito al valore TMS_ROOT_ID.
contentRating Testo o Valutazione Obbligatorio per i contenuti per adulti, vivamente consigliato negli altri casi Perché? - Classificazione complessiva dei contenuti trasmessi. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, sono accettate due varianti:
  • L'agenzia di rating anteposta alla valutazione con uno spazio vuoto nel 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 valutazione.
contentRating.advisoryCode Testo Il codice di avviso per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogo, FV = Violenza fantasy, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza.

Esempi

Una puntata TV viene trasmessa sull'emittente televisiva Example TV (BroadcastService) tra le 21:00 e le 21:30 del 12 ottobre 2019:

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": "Content To Be Announced",
  "description": "Content 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 dell'emittente televisiva Example TV (BroadcastService) è fuori onda tra le 12:00 e le 20:00 (modellato come due blocchi Off Air contigui di 4 ore) e trasmette un programma chiamato My favorite show tra le 20:00 e le 24:00:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16: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",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16: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/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "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à: