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, Organization. Per comprendere meglio la relazione tra questi tipi, consulta i concetti relativi ai canali Live TV.

Tabella BroadcastService Specification

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: impostato sempre su ["http://schema.org", {"@language": "xx"}]
  • dove "xx" rappresenta la lingua delle stringhe nel feed. Per ogni contesto dell'entità principale, l'attributo @language deve essere impostato 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/doppiaggio è l'inglese.
@type Testo Obbligatorio: impostato 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
  • 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.
url URL Obbligatorio se applicabile: l'URL canonico del servizio di trasmissione se il canale è disponibile per la visualizzazione su internet. È facoltativo per un servizio trasmesso via cavo/satellitare/etere. Google utilizza questo URL per associare i contenuti del tuo feed ai contenuti dei database di Google.
url deve soddisfare i seguenti requisiti:
  • url deve essere univoco a livello globale
  • url deve contenere un URL canonico funzionante che Google può eseguire la scansione.
Per il link diretto per la riproduzione, consulta la proprietà urlTemplate dell'oggetto target.
name Testo Obbligatorio: il nome della rete.
  • Utilizza un array per elencare i nomi in lingue diverse. Consulta l'esempio Più regioni e lingue.
  • Tieni presente che è supportato un solo nome per impostazioni internazionali (coppia lingua-paese).
broadcastDisplayName Testo Obbligatorio: il nome visualizzato della rete che gli utenti potrebbero vedere in genere nelle guide dei programmi e così via. Il valore può essere uguale al valore del nome.
callSign Testo L'indicativo di chiamata ufficiale del servizio di trasmissione emesso dal governo.
inLanguage Testo o Lingua Molto consigliato Perché? La lingua principale di trasmissione del canale. Utilizza uno dei codici lingua dello standard IETF BCP 47.
category Testo Molto consigliato Perché? Una categoria per l'articolo. I segni maggiori o le barre possono essere utilizzati 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 televisiva solo per adulti: la classificazione più restrittiva per i contenuti trasmessi sul canale. Se la classificazione dei contenuti è fornita sotto forma di stringa di testo, l'ente di classificazione deve essere anteposto alla classificazione con uno spazio intermedio; ad esempio, una classificazione "TV-Y" dell'ente "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 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.
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 Country, State, City o GeoShape Obbligatorio se applicabile: questo campo è obbligatorio se il passaggio di canale è 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 Country, State, City con GeoShape.
    		•
    logo ImageObject Obbligatorio se l'integrazione è con Google TV. Consigliato vivamente 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, ben visibile su uno sfondo scuro.
    • L'immagine del logo deve avere proporzioni 1:1, 4:3 o 16:9 (in questo ordine di preferenza) e una risoluzione di almeno 80 x 80 pixel.
    • Utilizza il valore forDarkBackground per il nome della proprietà personalizzata contentAttributes all'interno della proprietà additionalProperty per indicare il tipo di sfondo su cui deve essere utilizzato il logo.
    • Lo spazio interno in lunghezza o larghezza (ma non in entrambe) è accettabile se aggiunto per mantenere le proporzioni.
    • Per altri requisiti e specifiche, consulta la sezione Immagini.
    Vedi l'esempio seguente
    potentialAction WatchAction Obbligatorio se applicabile: un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per maggiori dettagli, consulta le proprietà di markup delle azioni.
    videoFormat Testo La definizione di qualità più elevata supportata da 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.
    broadcastTimezone Testo Il fuso orario di questo servizio di trasmissione in formato IANA, ad esempio America/Los_Angeles. Utilizza un array per più fusi orari.
    broadcastAffiliateOf Organizzazione Obbligatorio: la rete televisiva che fornisce la programmazione per questo servizio di trasmissione o l'organizzazione a cui appartiene questo servizio di trasmissione.
    broadcastAffiliateOf.@id Testo Obbligatorio: impostato su @id della rete TV.
    broadcastAffiliateOf.@type Testo Obbligatorio: impostato sempre su Organization.
    identifier PropertyValue Molto consigliato Perché? - ID esterno o un altro ID che identifica questa entità, ad esempio _PARTNER_ID_. Sono consentiti più identificatori. Per maggiori dettagli, consulta la sezione Proprietà identificatore.
    popularityScore PopularityScoreSpecification Molto consigliato Perché? Un 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 nei tuoi feed e tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
    popularityScore.@type Testo Deve essere sempre impostato su PopularityScoreSpecification.
    popularityScore.value Number Un valore numerico non negativo che indica la popolarità dell'entità. Un punteggio più alto indica una maggiore popolarità.
    popularityScore.eligibleRegion Paese Regioni in cui è applicabile questo 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à a livello di località 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: impostato sempre su ["http://schema.org", {"@language": "xx"}]
    • dove "xx" rappresenta la lingua delle stringhe nel feed. Per ogni contesto dell'entità principale, l'attributo @language deve essere impostato 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/doppiaggio è l'inglese.
    @type Testo Obbligatorio: impostato 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 (Uniform Resource Identifier)
    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 nome del servizio TV.
    • Utilizza un array per elencare i nomi in lingue diverse. Consulta l'esempio Più regioni e lingue.
    • Tieni presente che è supportato un solo nome per impostazioni internazionali (coppia lingua-paese).
    areaServed Country, State, City 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 e ExampleTV San Diego.
    provider.@id Testo Obbligatorio: l'ID dell'operatore TV.
    provider.@type Testo Obbligatorio: impostato sempre su Organization.
    identifier PropertyValue Molto consigliato Perché? - ID esterno o un altro ID che identifica questa entità, ad esempio un ID TMS Gracenote per questo servizio di trasmissione. Sono consentiti più identificatori. Per maggiori dettagli, consulta la sezione Proprietà identificatore.

    Esempi di CableOrSatelliteService

    Esempio di un 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 multicanale 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: impostato sempre su ["http://schema.org", {"@language": "xx"}]
    • dove "xx" rappresenta la lingua delle stringhe nel feed. Per ogni contesto dell'entità principale, l'attributo @language deve essere impostato 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/doppiaggio è l'inglese.
    @type Testo Obbligatorio: impostato 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 (Uniform Resource Identifier)
    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.
    broadcastChannelId Testo Obbligatorio: un identificatore univoco che consente di identificare questo BroadcastService come servizio TV via cavo, via satellite o via internet.
    • Negli Stati Uniti, in genere si tratta di un numero per la TV via cavo o satellitare.
    • Per un servizio TV su internet (ad esempio un vMVPD), fornisci il nome del canale.
    channelOrder Number Obbligatorio per Google TV, facoltativo in caso contrario: utilizza questa proprietà per indicare l'ordine in cui i canali devono essere visualizzati nella guida ai programmi elettronica per le integrazioni di Google TV.

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

    Esempi di TelevisionChannel

    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: impostato sempre su ["http://schema.org", {"@language": "xx"}]
    • dove "xx" rappresenta la lingua delle stringhe nel feed. Per ogni contesto dell'entità principale, l'attributo @language deve essere impostato 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/doppiaggio è l'inglese.
    @type Testo Obbligatorio: impostato 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 (Uniform Resource Identifier)
    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 nome della rete TV, del fornitore di contenuti TV o dell'operatore TV.
    • Utilizza un array per elencare i nomi in lingue diverse. Consulta l'esempio Più regioni e lingue.
    • Tieni presente che è supportato un solo nome per impostazioni internazionali (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 Molto consigliato Perché? L'URL di una pagina di Wikipedia che può identificare la rete televisiva. Deve essere diverso dalla proprietà url. Compila solo con la pagina di Wikipedia che parla di una singola entità di canale/rete. Tieni presente che le pagine di Wikipedia potrebbero utilizzare la terminologia "canale".
    potentialAction WatchAction Obbligatorio se applicabile: questo campo è obbligatorio se hai più canali (BroadcastService) che fanno riferimento all'organizzazione. Un oggetto di markup dell'azione che fornisce i dettagli dell'azione. Per maggiori dettagli, consulta le proprietà di markup delle azioni.
    url URL L'URL dell'organizzazione. Google utilizza questo URL per riconciliare con precisione questa organizzazione con quella presente nei database di Google.
    identifier PropertyValue Molto consigliato Perché? - ID esterno o un altro ID che identifica questa entità, ad esempio un ID TMS per questa organizzazione. Sono consentiti più identificatori. Per maggiori dettagli, consulta la sezione Proprietà identificatore.
    popularityScore PopularityScoreSpecification Molto consigliato Perché? Un 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 nei tuoi feed e tra tutte le entità del tuo catalogo. Per impostazione predefinita, il punteggio di popolarità di un'entità è impostato su 0.
    popularityScore.@type Testo Deve essere sempre impostato su PopularityScoreSpecification.
    popularityScore.value Number Un valore numerico non negativo che indica la popolarità dell'entità. Un punteggio più alto indica una maggiore popolarità.
    popularityScore.eligibleRegion Paese Regioni in cui è applicabile questo 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à a livello di località 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à: