Proprietà di markup dei contenuti di canali TV in diretta

Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per i tipi di entità BroadcastService, CableOrSatelliteService, TelevisionChannel e Organization. Per comprendere meglio la relazione tra questi tipi, esamina i concetti relativi ai canali LiveTV.

Tabella delle specifiche BroadcastService

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio - Imposta sempre su ["http://schema.org", {"@language": "xx"}]
  • Dove "xx" rappresenta la lingua delle stringhe nel feed. In ogni contesto di entità principale deve essere impostato il codice @language sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, si presume che i nomi siano in spagnolo anche se la lingua dei sottotitoli e del doppiaggio è in inglese.
@type Testo Obbligatorio - Imposta sempre su BroadcastService.
@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.
url URL Obbligatorio se applicabile: l'URL canonico del servizio di trasmissione se il canale può essere visualizzato su internet. È opzionale per un servizio fornito via cavo/satellite/over-the-air. Google utilizza questo URL per abbinare i contenuti del tuo feed ai contenuti nei propri database.
url deve soddisfare i seguenti requisiti:
  • url deve essere univoco a livello globale
  • url deve contenere un URL canonico funzionante di cui Google possa eseguire la scansione.
Per il link diretto della riproduzione, vedi invece la proprietà urlTemplate dell'oggetto target.
name Testo Obbligatorio: il nome della rete.
  • Utilizza un array per elencare i nomi in lingue diverse. Vedi l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
broadcastDisplayName Testo Obbligatorio: il nome visualizzato della rete, che gli utenti solitamente possono trovare nelle guide dei programmi e così via. Il valore può essere uguale al valore del nome.
callSign Testo L'indicativo di chiamata ufficiale e rilasciato dalle autorità del servizio di trasmissione.
inLanguage Testo o Lingua Altamente consigliato Perché? La lingua principale di trasmissione del canale. Utilizza uno dei codici lingua dello standard IETF BCP 47.
category Testo Altamente consigliato Perché? Una categoria per l'articolo. È possibile utilizzare segni più grandi o barre per indicare in modo informale una gerarchia di categorie. ad es.Sport, Sport > Calcio, notizie, film, musica, documentari.`
contentRating Testo o Valutazione Obbligatorio per un servizio di trasmissione TV riservato a un pubblico adulto: classificazione più restrittiva per i contenuti trasmessi sul canale. Se la classificazione dei contenuti viene fornita sotto forma di stringa di testo, l'agenzia di classificazione deve essere anteposta a uno spazio vuoto all'inizio della classificazione. ad esempio "TV-Y" valutazione dall'agenzia "TVPG" negli Stati Uniti è descritta come "TVPG TV-Y". Consulta l'elenco delle agenzie.
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.
description Testo Una descrizione del servizio di trasmissione. Limite di 300 caratteri. Utilizza un array per fornire le descrizioni in più lingue e/o di lunghezze diverse.
slogan Testo Uno slogan del servizio di trasmissione.
areaServed Paese, Stato, Città o GeoShape Obbligatorio se applicabile: questo passaggio è obbligatorio se il passaggio del canale viene eseguito dal fornitore di servizi TV. L'area in cui gli utenti possono aspettarsi di ricevere il servizio di trasmissione. Utilizza il codice paese ISO 3166-1 per specificare i paesi.
  • Utilizza un array per rappresentare più aree.
  • Non combinare Paese, Stato, Città con GeoShape.
  • logo ImageObject Obbligatorio in caso di integrazione con Google TV. Altamente consigliato Perché? Un'immagine che rappresenta questo servizio di trasmissione.
    • Le integrazioni di Google TV richiedono un logo che possa essere utilizzato su uno sfondo scuro. Deve avere uno sfondo trasparente con un logo colorato o bianco, chiaramente visibile su uno sfondo scuro.
    • L'immagine del logo deve rispettare le proporzioni 1:1, 4:3 o 16:9 (in questo ordine di preferenza) e avere una risoluzione di almeno 80 x 80 px.
    • Utilizza il valore forDarkBackground per il nome della proprietà personalizzata contentAttributes come parte della proprietà additionalProperty per indicare il tipo di sfondo su cui deve essere utilizzato il logo.
    • La spaziatura interna in lunghezza o larghezza (ma non in entrambe) è accettabile se viene aggiunta per mantenere le proporzioni.
    • Per altri requisiti e specifiche, consulta la sezione Immagine.
    Guarda l'esempio riportato di seguito.
    potentialAction WatchAction Obbligatorio se applicabile: un oggetto di markup Azione che fornisce i dettagli dell'azione. Per informazioni dettagliate, consulta le proprietà di markup delle azioni.
    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.
    broadcastTimezone Testo Fuso orario del servizio di trasmissione in formato IANA. ad esempio America/Los_Angeles. Utilizza un array per più fusi orari.
    broadcastAffiliateOf Organizzazione Obbligatorio: la rete TV che fornisce la programmazione di questo servizio di trasmissione o l'organizzazione a cui appartiene il servizio.
    broadcastAffiliateOf.@id Testo Obbligatorio: imposta su @id della rete TV.
    broadcastAffiliateOf.@type Testo Obbligatorio - Imposta sempre su Organization.
    identifier PropertyValue Altamente consigliato Perché? - ID esterno o di altro tipo che identifica questa entità, ad esempio _PARTNER_ID_. Sono consentiti più identificatori. Per informazioni dettagliate, consulta la sezione Proprietà dell'identificatore.
    popularityScore PopularityScoreSpecification Altamente consigliato Perché? Punteggio utilizzato da Google, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo. pertanto la scala del punteggio deve essere coerente in tutti i feed, tra tutte le entità nel catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
    popularityScore.@type Testo Imposta sempre su PopularityScoreSpecification.
    popularityScore.value Number Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto corrisponde a una maggiore popolarità.
    popularityScore.eligibleRegion Paese Regioni in cui è applicabile il punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su EARTH. Per impostazione predefinita, questa proprietà è impostata su EARTH.
    Note: La popolarità specifica per località ha la precedenza sulla popolarità globale (EARTH)

    Esempio BroadcastService

    {
        "@context": [
            "http://schema.org",
            {
                "@language": "en"
            }
        ],
        "@type": "BroadcastService",
        "@id": "http://example.com/stations/example-tv",
        "name": "EXAMPLE-TV",
        "broadcastDisplayName": "ABCD",
        "url": "http://example.com/stations/example-tv",
        "callSign": "EXA-TV",
        "videoFormat": "SD",
        "inLanguage": "en",
        "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"
            }
        ],
        "popularityScore": {
            "@type": "PopularityScoreSpecification",
            "value": 178,
            "eligibleRegion": [
                {
                    "@type": "Country",
                    "name": "US"
                }
            ]
        },
        "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",
                    "authenticator": {
                        "@type": "Organization",
                        "name": "TVE"
                    }
                },
                "eligibleRegion": [
                    {
                        "@type": "Country",
                        "name": "US"
                    }
                ]
            }
        },
        "logo": [
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Light",
                "contentUrl": "http://example.com/images/example-logo-light.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forLightBackground"
                        ]
                    }
                ]
            },
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Dark",
                "contentUrl": "http://example.com/images/example-logo-dark.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forDarkBackground"
                        ]
                    }
                ]
            }
        ]
    }
    

    Tabella delle specifiche CableOrSatelliteService

    Proprietà Tipo previsto Descrizione
    @context Testo Obbligatorio - Imposta sempre su ["http://schema.org", {"@language": "xx"}]
    • Dove "xx" rappresenta la lingua delle stringhe nel feed. In ogni contesto di entità principale deve essere impostato il codice @language sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, si presume che i nomi siano in spagnolo anche se la lingua dei sottotitoli e del doppiaggio è in inglese.
    @type Testo Obbligatorio - Imposta sempre su CableOrSatelliteService.
    @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
    • Sotto forma di URI (Unified Resource Identifier)
    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 nome del servizio TV.
    • Utilizza un array per elencare i nomi in lingue diverse. Vedi l'esempio Più regioni e lingue.
    • Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
    areaServed Paese, Stato, Città o GeoShape Obbligatorio: l'area in cui gli utenti possono aspettarsi di ricevere il servizio di trasmissione.
    provider Organizzazione Obbligatorio: il fornitore principale del servizio, se applicabile. Ad esempio, ExampleTV è il fornitore dei suoi servizi regionali ExampleTV San Francisco ed ExampleTV San Diego.
    provider.@id Testo Obbligatorio: l'ID dell'operatore TV.
    provider.@type Testo Obbligatorio - Imposta sempre su Organization.
    identifier PropertyValue Altamente consigliato Perché? - ID esterno o di altro tipo che identifica l'entità, ad esempio un ID TMS di Gracenote per questo servizio di trasmissione. Sono consentiti più identificatori. Per informazioni dettagliate, consulta la sezione Proprietà dell'identificatore.

    Esempi di CableOrSatelliteService

    Esempio di servizio via cavo o satellitare:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/provider-lineups/exampletv-san-francisco",
      "name":"ExampleTV San Francisco",
      "provider": {
        "@type": "Organization",
        "@id": "http://example.com/providers/exampletv"
      },
      "areaServed":[
        {
          "@type":"GeoShape",
          "@id": "http://example.com/area1"
        }
      ],
      "identifier": {
        "@type": "PropertyValue",
        "propertyID": "TMS_ID",
        "value": "12345"
      }
    }
    
    {
      "@type": "GeoShape",
      "@id": "http://example.com/area1",
      "addressCountry": "US",
      "postalCode": [
        "94118",
        "94119"
      ]
    }
    

    Esempio di un distributore virtuale di programmazione video multicanale (vMVPD):

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/providers/my-online-example-tv",
      "name":"My Online Example TV",
      "provider": {
        "@type": "Organization",
        "@id": "http://my-online-tv.com"
      },
      "areaServed":[
        {
          "@type":"Country",
          "name": "US",
        },
        {
          "@type":"Country",
          "name": "CA",
        }
      ]
    }
    

    Tabella delle specifiche di TelevisionChannel

    Proprietà Tipo previsto Descrizione
    @context Testo Obbligatorio - Imposta sempre su ["http://schema.org", {"@language": "xx"}]
    • Dove "xx" rappresenta la lingua delle stringhe nel feed. In ogni contesto di entità principale deve essere impostato il codice @language sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, si presume che i nomi siano in spagnolo anche se la lingua dei sottotitoli e del doppiaggio è in inglese.
    @type Testo Obbligatorio - Imposta sempre su TelevisionChannel.
    @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
    • Sotto forma di URI (Unified Resource Identifier)
    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.
    broadcastChannelId Testo Obbligatorio: un identificatore univoco tramite il quale questo BroadcastService può essere identificato come servizio TV via cavo, satellitare o via internet.
    • Negli Stati Uniti, si tratta in genere di un numero per la TV via cavo o satellitare.
    • Per un servizio di TV via internet (ad esempio, vMVPD), fornisci il nome del canale.
    channelOrder Number Obbligatorio per Google TV, facoltativo altrimenti: utilizza questa proprietà per indicare l'ordine in cui devono essere visualizzati i canali nella guida alla programmazione elettronica per le integrazioni di Google TV.

    Il valore channelOrder deve essere univoco in tutti i canali del feed e idealmente dovrebbe iniziare da 1. channelOrder non può avere un valore negativo o pari a 0.
    broadcastServiceTier Testo Utilizza i seguenti valori:
    • Free per il canale che non richiede iscrizioni.
    • Standard per i canali inclusi in un'iscrizione di base.
    • Premium per i canali che richiedono un pagamento oltre all'iscrizione di base.
    Utilizza un array per fornire più valori.
    inBroadcastLineup CableOrSatelliteService Obbligatorio: il @id di CableOrSatelliteService che fornisce questo canale agli spettatori.
    providesBroadcastService BroadcastService Obbligatorio: il @id di BroadcastService di cui viene fornita la programmazione da questo canale.

    Esempi di canali televisivi

    Esempio di canale TV via cavo o satellitare:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/exampleTV/example-tv-7",
      "broadcastChannelId":"7",
      "channelOrder": 1,
      "broadcastServiceTier":["Premium", "Standard"],
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/exampleTV-san-francisco"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/example-tv"
      }
    }
    

    Esempio per un canale TV online:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/my-online-example-tv/sport-channel",
      "broadcastChannelId":"sport-channel",
      "channelOrder": 3,
      "broadcastServiceTier":"Premium",
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/my-online-example-tv"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/sport-channel"
      }
    }
    

    Tabella delle specifiche dell'organizzazione

    Proprietà Tipo previsto Descrizione
    @context Testo Obbligatorio - Imposta sempre su ["http://schema.org", {"@language": "xx"}]
    • Dove "xx" rappresenta la lingua delle stringhe nel feed. In ogni contesto di entità principale deve essere impostato il codice @language sul codice lingua appropriato nel formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, si presume che i nomi siano in spagnolo anche se la lingua dei sottotitoli e del doppiaggio è in inglese.
    @type Testo Obbligatorio - Imposta sempre su Organization.
    @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
    • Sotto forma di URI (Unified Resource Identifier)
    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 nome della rete TV, del fornitore di contenuti TV o dell'operatore TV.
    • Utilizza un array per elencare i nomi in lingue diverse. Vedi l'esempio Più regioni e lingue.
    • Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
    description Testo Una descrizione dell'organizzazione. Limite di 300 caratteri. Utilizza un array per fornire le descrizioni in più lingue e/o di lunghezze diverse.
    sameAs URL Altamente consigliato Perché? Un URL a una pagina Wikipedia in grado di identificare la rete TV. Deve essere diverso dalla proprietà url. Viene completata solo la pagina Wikipedia che riguarda una singola entità canale/rete. Tieni presente che le pagine di Wikipedia potrebbero utilizzare la terminologia "canale".
    potentialAction WatchAction Obbligatorio se applicabile: questo passaggio è obbligatorio se hai più canali (BroadcastService) che fanno riferimento all'organizzazione. Un oggetto di markup Azione che fornisce i dettagli dell'azione. Per informazioni dettagliate, consulta le proprietà di markup delle azioni.
    url URL L'URL dell'organizzazione. Google utilizza questo URL per riconciliare in modo accurato questa organizzazione con l'organizzazione nei database di Google.
    identifier PropertyValue Altamente consigliato Perché? - ID esterno o di altro tipo che identifica l'entità, ad esempio un ID TMS per questa organizzazione. Sono consentiti più identificatori. Per informazioni dettagliate, consulta la sezione Proprietà dell'identificatore.
    popularityScore PopularityScoreSpecification Altamente consigliato Perché? Punteggio utilizzato da Google, insieme ad altri indicatori, per determinare quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto ad altri contenuti del tuo catalogo. pertanto la scala del punteggio deve essere coerente in tutti i feed, tra tutte le entità nel catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
    popularityScore.@type Testo Imposta sempre su PopularityScoreSpecification.
    popularityScore.value Number Un valore numerico non negativo che indica la popolarità dell'entità; un punteggio più alto corrisponde a una maggiore popolarità.
    popularityScore.eligibleRegion Paese Regioni in cui è applicabile il punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, impostalo su EARTH. Per impostazione predefinita, questa proprietà è impostata su EARTH.
    Note: La popolarità specifica per località ha la precedenza sulla popolarità globale (EARTH)

    Esempio di organizzazione

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"Organization",
      "@id":"http://example.com/networks/abcd-network",
      "name":"ABCD",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "TMS_ID",
          "value": "12345"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "_PARTNER_ID_",
          "value": "exampletv-12345"
        }
      ],
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://example.com/networkstream",
          "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": "2050-10-21T10:35:29Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://example.com/subscription",
            "name": "ABCD",
            "sameAs": "http://example.com/subscription",
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            }
          ]
        }
      },
      "popularityScore": {
        "@type": "PopularityScoreSpecification",
        "value": 178,
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          }
        ]
      }
    }
    

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