Proprietà del markup dei contenuti dei 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, rivedi i concetti dei canali LiveTV.

Tabella delle specifiche di BroadcastService

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: sempre impostato su ["http://schema.org", {"@language": "xx"}]
  • Dove "xx" rappresenta la lingua delle stringhe nel feed. Il contesto di ogni entità principale deve essere impostato su @language del codice lingua appropriato nel formato formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, i nomi si suppongono in spagnolo, anche se la lingua del sottotitolo/dub è in inglese.
@type Testo Obbligatorio: sempre impostato su BroadcastService.
@id URL Obbligatorio: l'identificatore del contenuto 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à dell'URL del programma cambia). verrà considerato come una stringa opaca e non deve necessariamente essere un link funzionante.
  • sotto forma di identificatore unificato di risorse (URI)
  • Il dominio utilizzato per il valore @id deve essere di proprietà della tua organizzazione.
Poiché la proprietà url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare la proprietà 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 è disponibile per la visualizzazione su Internet. È opzionale per un servizio erogato via cavo/satellitare/over-the-air. Google utilizza questo URL per abbinare i contenuti nel tuo feed ai contenuti nei suoi database.
url deve soddisfare i seguenti requisiti:
  • Il campo url deve essere univoco a livello globale
  • url deve contenere un URL canonico funzionante che Google possa sottoporre a scansione.
Per il link diretto della riproduzione, consulta invece la proprietà urlTemplate dell'oggetto target.
name Testo Obbligatorio: il nome della rete.
  • Utilizza un array per elencare i nomi in diverse lingue. Consulta l'esempio Più aree geografiche 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 possono in genere visualizzare nelle guide del programma e così via. Il valore potrebbe essere uguale al valore del nome.
callSign Testo L'indicativo di chiamata ufficiale del servizio di trasmissione.
inLanguage Testo o Lingua Fortemente consigliatoPerché? La lingua di trasmissione principale del canale. Usa uno dei codici lingua dello standard IETF BCP 47.
category Testo Fortemente consigliatoPerché? Una categoria dell'articolo. Puoi utilizzare segni più grandi o barre per indicare in modo informale una gerarchia di categorie, ad esempio Sport, Sport > Calcio, Notizie, Film, Musica, Documentario.`
contentRating Testo o Valutazione Obbligatorio per un servizio di trasmissione TV riservato a un pubblico adulto: la classificazione più restrittiva per la trasmissione di contenuti sul canale. Se la classificazione dei contenuti è espressa sotto forma di stringa di testo, l'agenzia di classificazione deve essere anteposta alla classificazione con spazio vuoto; ad esempio, la classificazione "TV-Y" dell'agenzia "TVPG" negli Stati Uniti è definita "TVPG Y". Consulta l'elenco delle agenzie.
contentRating.author Testo o Organizzazione Obbligatorio se contentRating utilizza Rating: il nome dell'agenzia di valutazione.
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 = Lingua, S = Contenuti di natura sessuale, V = Violenza.
description Testo Una descrizione del servizio di trasmissione. 300 caratteri. Utilizza un array per fornire le descrizioni in più lingue e/o in lunghezze diverse.
slogan Testo Uno slogan del servizio di trasmissione.
areaServed Paese, Stato, Città o GeoShape Obbligatorio se applicabile: è richiesto se il cambio di canale viene evaso 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 se si esegue l'integrazione con Google TV. Altamente consigliato altrimenti Perché? Un'immagine che rappresenta questo servizio di trasmissione.
    • Le integrazioni di Google TV richiedono un logo che possa essere utilizzato su 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 quest'ordine di preferenza) e deve avere una risoluzione pari o superiore a 80 x 80 px.
    • Utilizza il valore forDarkBackground per il nome della proprietà personalizzata contentAttributes all'interno della proprietà additionalProperty per indicare il tipo di sfondo su cui utilizzare il logo.
    • L'imbottitura in lunghezza o larghezza (ma non in entrambe) è accettabile se aggiunta per mantenere le proporzioni.
    • Consulta la sezione Immagine per altri requisiti e specifiche.
    Vedi l'esempio riportato di seguito
    potentialAction WatchAction Obbligatorio se applicabile: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per ulteriori dettagli, consulta le proprietà del markup delle azioni.
    videoFormat Testo La definizione di qualità più elevata supportata su questo servizio di trasmissione, ad esempio
    • "SD" per la definizione standard.
    • "HD" per l'alta definizione.
    • "2K" per la risoluzione in 2K.
    • "4K" per la risoluzione 4K.
    • "8K" per la risoluzione 8K.
    broadcastTimezone Testo Il fuso orario di questo servizio di trasmissione in formato IANA, ad esempio America/Los_Angeles. Utilizza una matrice per più fusi orari.
    broadcastAffiliateOf Organizzazione Obbligatorio: la rete TV che fornisce la programmazione per questo servizio di trasmissione o per l'organizzazione a cui appartiene.
    broadcastAffiliateOf.@id Testo Obbligatorio: imposta il valore @id della rete TV.
    broadcastAffiliateOf.@type Testo Obbligatorio: sempre impostato su Organization.
    identifier PropertyValue Fortemente consigliatoPerché? - ID esterno o un altro ID che identifica questa entità, ad esempio _PARTNER_ID_. Sono ammessi più identificatori. Per ulteriori dettagli, consulta la sezione Proprietà degli identificatori.
    popularityScore PopolaritàPunteggio Specifica Fortemente consigliatoPerché? Punteggio utilizzato da Google e da altri indicatori per stabilire quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto agli altri contenuti del tuo catalogo. Pertanto, la scala del punteggio deve essere coerente con tutti i tuoi feed, tra tutte le entità del tuo 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 significa maggiore popolarità.
    popularityScore.eligibleRegion Paese Regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, imposta su EARTH. Per impostazione predefinita, questa proprietà è impostata su EARTH.
    Note: La popolarità specifica per locale ha la precedenza sulla popolarità a livello globale (EARTH)

    Esempio di 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 di CableOrSatelliteService

    Proprietà Tipo previsto Descrizione
    @context Testo Obbligatorio: sempre impostato su ["http://schema.org", {"@language": "xx"}]
    • Dove "xx" rappresenta la lingua delle stringhe nel feed. Il contesto di ogni entità principale deve essere impostato su @language del codice lingua appropriato nel formato formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, i nomi si suppongono in spagnolo, anche se la lingua del sottotitolo/dub è in inglese.
    @type Testo Obbligatorio: sempre impostato su CableOrSatelliteService.
    @id URL Obbligatorio: l'identificatore del contenuto in formato URI; ad esempio, https://example.com/1234abc.
    @id deve soddisfare i seguenti requisiti:
    • Univoco a livello globale nel tuo catalogo
    • Statiche
    • sotto forma di identificatore unificato di risorse (URI)
    Poiché la proprietà url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare la proprietà 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 diverse lingue. Consulta l'esempio Più aree geografiche 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: sempre impostato su Organization.
    identifier PropertyValue Fortemente consigliatoPerché? - ID esterno o altro che identifica questa entità, ad esempio un ID Gracenote TMS per questo servizio di trasmissione. Sono ammessi più identificatori. Per ulteriori dettagli, consulta la sezione Proprietà degli identificatori.

    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 di programmazione video virtuale (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: sempre impostato su ["http://schema.org", {"@language": "xx"}]
    • Dove "xx" rappresenta la lingua delle stringhe nel feed. Il contesto di ogni entità principale deve essere impostato su @language del codice lingua appropriato nel formato formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, i nomi si suppongono in spagnolo, anche se la lingua del sottotitolo/dub è in inglese.
    @type Testo Obbligatorio: sempre impostato su TelevisionChannel.
    @id URL Obbligatorio: l'identificatore del contenuto in formato URI; ad esempio, https://example.com/1234abc.
    @id deve soddisfare i seguenti requisiti:
    • Univoco a livello globale nel tuo catalogo
    • Statiche
    • sotto forma di identificatore unificato di risorse (URI)
    Poiché la proprietà url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare la proprietà url di un'entità come @id. Per ulteriori dettagli, consulta la sezione Identificatore.
    broadcastChannelId Testo Obbligatorio: un identificatore univoco con cui si può identificare questo BroadcastService come servizio via cavo, satellitare o Internet TV.
    • Negli Stati Uniti, si tratta in genere di un numero per la TV via cavo o satellitare.
    • Per un servizio Internet TV (ad esempio, un vMVPD), specifica 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 dovrebbe essere univoco in tutti i canali del feed e idealmente dovrebbe iniziare da 1. channelOrder non può avere un valore negativo o 0.
    broadcastServiceTier Testo Utilizza i seguenti valori:
    • Free per il canale che non richiede iscrizioni.
    • Standard per i canali inclusi in un abbonamento di base.
    • Premium per i canali che richiedono un pagamento oltre all'iscrizione di base.
    Utilizza un array per fornire più valori.
    inBroadcastLineup Servizio Cavi o Satellite Obbligatorio: il @id dei CableOrSatelliteService che fornisce questo canale agli spettatori.
    providesBroadcastService Servizio di trasmissione Obbligatorio: il @id dei BroadcastService di cui fornisce la programmazione.

    Esempi di canali televisivi

    Esempio di un 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 di 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: sempre impostato su ["http://schema.org", {"@language": "xx"}]
    • Dove "xx" rappresenta la lingua delle stringhe nel feed. Il contesto di ogni entità principale deve essere impostato su @language del codice lingua appropriato nel formato formato BCP 47. Ad esempio, se la lingua è impostata sullo spagnolo, i nomi si suppongono in spagnolo, anche se la lingua del sottotitolo/dub è in inglese.
    @type Testo Obbligatorio: sempre impostato su Organization.
    @id URL Obbligatorio: l'identificatore del contenuto in formato URI; ad esempio, https://example.com/1234abc.
    @id deve soddisfare i seguenti requisiti:
    • Univoco a livello globale nel tuo catalogo
    • Statiche
    • sotto forma di identificatore unificato di risorse (URI)
    Poiché la proprietà url di un'entità soddisfa tutti i requisiti come identificatore, ti consigliamo di utilizzare la proprietà 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 diverse lingue. Consulta l'esempio Più aree geografiche e lingue.
    • Tieni presente che è supportato un solo nome per lingua (coppia lingua-paese).
    description Testo Una descrizione dell'organizzazione. 300 caratteri. Utilizza un array per fornire le descrizioni in più lingue e/o in lunghezze diverse.
    sameAs URL Fortemente consigliatoPerché? Un URL che rimanda a una pagina di Wikipedia in grado di identificare la rete TV. Deve essere diverso dalla proprietà dell'URL. Compila solo con la pagina di Wikipedia che parla di un singolo canale/entità di rete. Tieni presente che le pagine di Wikipedia potrebbero utilizzare la terminologia "canale".
    potentialAction WatchAction Obbligatorio se applicabile: richiesto se hai più canali (BroadcastService) che fanno riferimento all'organizzazione. Un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per ulteriori dettagli, consulta le proprietà del markup delle azioni.
    url URL L'URL dell'organizzazione. Google utilizza questo URL per riconciliare con precisione questa organizzazione con l'organizzazione nei suoi database.
    identifier PropertyValue Fortemente consigliatoPerché? - ID esterno o di altro tipo che identifica questa entità, ad esempio un ID TMS per questa organizzazione. Sono ammessi più identificatori. Per ulteriori dettagli, consulta la sezione Proprietà degli identificatori.
    popularityScore PopolaritàPunteggio Specifica Fortemente consigliatoPerché? Punteggio utilizzato da Google e da altri indicatori per stabilire quali contenuti multimediali riprodurre per gli utenti. Questo punteggio rappresenta la popolarità dei contenuti rispetto agli altri contenuti del tuo catalogo. Pertanto, la scala del punteggio deve essere coerente con tutti i tuoi feed, tra tutte le entità del tuo 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 significa maggiore popolarità.
    popularityScore.eligibleRegion Paese Regioni in cui è applicabile questo punteggio di popolarità. Se il punteggio di popolarità è applicabile a livello globale, imposta su EARTH. Per impostazione predefinita, questa proprietà è impostata su EARTH.
    Note: La popolarità specifica per locale ha la precedenza sulla popolarità a livello 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à: