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, esamina i concetti relativi agli eventi TV in diretta.

Tabella delle specifiche BroadcastEvent

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio - Imposta sempre su ["http://schema.org", {"@language": "xx"}]
  • Sostituisci xx con il codice lingua dell'entità in formato formato BCP 47, ad esempio "en".
@type Testo Obbligatorio - Imposta 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
  • Statica; L'ID deve essere stabile e non cambiare nel tempo (anche se la proprietà url del podcast cambia). Verrà trattata come una stringa opaca e non deve essere necessariamente un link funzionante.
  • Sotto forma di URI (Unified Resource Identifier)
  • Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.
Poiché il valore url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare il valore 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. Limist da 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 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 L'elemento @id dell'entità BroadcastService che trasmette questo programma o questo evento.
workPerformed CreativeWork Obbligatorio se applicabile: utilizza questa proprietà quando i contenuti rientrano in 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 Imposta su Movie, TVSeries o TVEpisode.
workPerformed.@id URL Il @id dell'entità content.
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 Text o Country Obbligatorio se BroadcastEvent è per un evento SportsEvent, ad esempio ha la proprietà broadcastOfEvent: il paese in cui può essere trasmesso l'evento SportsEvent sottostante. Questo campo può essere una lista di nazioni qualora più paesi possano trasmettere l'evento SportsEvent.
videoFormat Testo La definizione di qualità più alta supportata da questo servizio di trasmissione. ad esempio
  • "SD" per la definizione standard.
  • "HD" per l'alta definizione.
  • "2K" per una risoluzione 2K.
  • "4K" per una risoluzione 4K.
  • "8K" per una risoluzione 8K.
contentToBeAnnounced Valore booleano Obbligatorio 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, 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 è prevista la trasmissione di contenuti 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 Imposta 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 un evento in live streaming meno impostato sul 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 informazioni dettagliate, consulta la sezione Proprietà dell'identificatore.
  • 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 si fa riferimento a un'entità con formato completo Movie, TVSeries, TVEpisode o SportsEvent utilizzando la proprietà workPerformed o broadcastOfEvent.
  • Il valore della proprietà deve riflettere i valori TMS_ID o TMS_ROOT_ID dell'entità Movie, TVSeries, TVEpisode o SportsEvent a cui idealmente farai riferimento utilizzando la proprietà workPerformed o broadcastOfEvent.
  • È preferibile usare TMS_ID rispetto al valore TMS_ROOT_ID.
contentRating Testo o Valutazione Obbligatorio per i contenuti per adulti, vivamente consigliato altrimenti 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 classificazione è stata preceduta da uno spazio vuoto. Ad esempio, "PG-13" valutazione dell'agenzia "MPAA" negli Stati Uniti deve essere descritto come "MPAA PG-13". Consulta l'elenco delle agenzie.
  • Il 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 consulenza per i contenuti. I valori accettati includono D, FV, L, S e V. D = Dialogo, FV = Violenza di fantasia, L = Linguaggio, S = Contenuti di natura sessuale, V = Violenza.

Esempi

Una puntata TV viene trasmessa sulla rete televisiva TV di esempio (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 TV di esempio (BroadcastService) tra le 21:00 e le 21:30 del 12 ottobre 2019 non è noto 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"
        }
      ]
    }
  }
}

Rete televisiva TV di esempio(BroadcastService) Il canale è non in onda tra le 12:00 e le 20:00 e trasmette 1 programma chiamato My favorite show tra le 8 alle 12 e alle 12:

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à: