Propiedades del lenguaje de marcado de contenido de canales de TV en vivo

En esta sección, se proporcionan los detalles de las propiedades de lenguaje de marcado de contenido para los tipos de entidades BroadcastService, CableOrSatelliteService, TelevisionChannel y Organization. Para comprender mejor la relación entre estos tipos, revisa los conceptos de Canales de TV en vivo.

Tabla de especificaciones de BroadcastService

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre establecido en ["http://schema.org", {"@language": "xx"}]
  • Donde "xx" representa el idioma de las strings en el feed. El contexto de cada entidad raíz debe tener su @language establecido en el código de idioma adecuado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en español, aunque el idioma de los subtítulos sea en inglés.
@type Texto Obligatorio: Siempre se establece en BroadcastService.
@id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Único a nivel global en el catálogo
  • Estático: El ID debe ser fijo y mantener el mismo formato con el paso del tiempo (incluso si cambia la propiedad URL del programa). Se tratará como una string opaca y no es necesario que sea un vínculo activo.
  • Tiene el formato de identificador unificado de recursos (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Debido a que la url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id. Consulta la sección Identificador para obtener más detalles.
url URL Obligatorio si corresponde: Es la URL canónica del servicio de transmisión si el canal está disponible para verlo en Internet. Es opcional para los servicios que se entregan por cable, satélite o por cable. Google usa esta URL para hacer coincidir el contenido de su feed con el contenido de sus bases de datos.
url debe cumplir con los siguientes requisitos:
  • url debe ser único a nivel global
  • url debe contener una URL canónica que Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta en su lugar la propiedad urlTemplate del objeto target.
name Texto Obligatorio: El nombre de la red.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de varios idiomas y regiones.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par de idioma-país).
broadcastDisplayName Texto Obligatorio: El nombre visible de la red que los usuarios suelen ver en las guías de programas, etc. El valor puede ser el mismo que el nombre.
callSign Texto Indicador oficial emitido por el Gobierno del servicio de transmisión.
inLanguage Texto o Idioma Muy recomendable ¿Por qué? El idioma de transmisión principal del canal. Utiliza uno de los códigos de idioma del estándar IETF BCP 47.
category Texto Muy recomendable ¿Por qué? Es una categoría para el artículo. Se pueden usar barras o letreros más grandes para indicar de forma informal una jerarquía de categorías, p. ej., Deportes > Fútbol, Noticias, Películas, Música o Documentales.
contentRating Texto o Calificación Obligatorio para un servicio de transmisión de TV solo para adultos: Es la clasificación más restrictiva para la transmisión de contenido del canal. Si la calificación del contenido se proporciona en la forma de una string de texto, la agencia de clasificación debe estar precedida de la calificación con espacios en blanco en el medio. Por ejemplo, una calificación de "TV-Y" de la agencia "TVPG" en EE.UU. se describe como "TVPG TV-Y". Consulte la lista de agencias.
contentRating.author Organización o texto Obligatorio si contentRating usa Rating: El nombre de la agencia de clasificación.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: El valor de la calificación.
contentRating.advisoryCode Texto Es el código de asesoramiento para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Dialogue, FV = Fantasy Violencia, L = Language, S = Sexual Content, V = Violencia.
description Texto Es una descripción del servicio de transmisión. con un límite de 300 caracteres. Usa un array para proporcionar las descripciones en varios idiomas o de diferentes longitudes.
slogan Texto Un eslogan del servicio de transmisión.
areaServed País, Estado, Ciudad o GeoShape Obligatorio si corresponde: Es obligatorio si el proveedor de servicios de TV completa el cambio de canal: El área en la que los usuarios pueden recibir el servicio de transmisión. Utiliza el código de país ISO 3166-1 para especificar los países.
  • Usa un array para representar varias áreas.
  • No mezcles País, Estado y Ciudad con GeoShape.
  • logo ImageObject Obligatorio si se integra en Google TV. Muy recomendable ¿Por qué? Una imagen que representa este servicio de transmisión.
    • Las integraciones de Google TV requieren un logotipo que se pueda usar sobre un fondo oscuro. Debe tener un fondo transparente con un logotipo de color o blanco, que sea claramente visible sobre un fondo oscuro.
    • La imagen del logotipo debe cumplir con la relación de aspecto de 1:1, 4:3 o 16:9 (en ese orden de preferencia), y debe tener una resolución de 80 x 80 px o superior.
    • Usa el valor forDarkBackground para el nombre personalizado de la propiedad contentAttributes como parte de la propiedad additionalProperty a fin de indicar el tipo de fondo en el que se debe usar el logotipo.
    • Se puede rellenar el largo o el ancho (pero no ambos) si se agrega para mantener la relación de aspecto.
    • Consulta la sección Imagen para ver otros requisitos y especificaciones.
    Consulta este ejemplo.
    potentialAction WatchAction Obligatorio si corresponde: Es un objeto de lenguaje de marcado de acciones que proporciona detalles de la acción. Para obtener más información, consulta las Propiedades de lenguaje de marcado de acciones.
    videoFormat Texto La definición de mayor calidad compatible con este servicio de transmisión; por ejemplo,
    • "SD" para definición estándar
    • "HD" para alta definición.
    • “2K” para resolución 2K.
    • “4K” para resolución 4K
    • “8K” para resolución de 8K.
    broadcastTimezone Texto Es la zona horaria de este servicio de emisión en formato IANA; por ejemplo, América/Los_Angeles. Usa un array para varias zonas horarias.
    broadcastAffiliateOf Organization Obligatorio: La red de TV que proporciona la programación para este servicio de transmisión o la organización a la que pertenece este servicio de transmisión.
    broadcastAffiliateOf.@id Texto Obligatorio: Se establece en @id de la red de TV.
    broadcastAffiliateOf.@type Texto Obligatorio: Siempre se establece en Organization.
    identifier PropertyValue Muy recomendable ¿Por qué? - Es un ID externo o algún otro ID que identifica a esta entidad, como _PARTNER_ID_. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
    popularityScore Especificación de PopularityScore Muy recomendable ¿Por qué? Corresponde a una puntuación que utiliza Google, además de otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido con respecto a otro contenido de su catálogo; por lo tanto, la escala de la puntuación debe ser coherente en todos sus feeds, entre todas las entidades de su catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
    popularityScore.@type Texto Siempre establecida en PopularityScoreSpecification.
    popularityScore.value Número Un valor numérico no negativo que indica la popularidad de la entidad; una puntuación más alta significa una mayor popularidad.
    popularityScore.eligibleRegion País Regiones donde se aplica esta puntuación de popularidad. Si la puntuación de popularidad es aplicable a nivel global, configúrala en EARTH. De forma predeterminada, esta propiedad se establece en EARTH.
    Note: La popularidad específica de la configuración regional tiene prioridad sobre la popularidad global (EARTH)

    Ejemplo de 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"
                        ]
                    }
                ]
            }
        ]
    }
    

    Tabla de especificaciones de CableOrSatelliteService

    Propiedad Tipo esperado Descripción
    @context Texto Obligatorio: Siempre establecido en ["http://schema.org", {"@language": "xx"}]
    • Donde "xx" representa el idioma de las strings en el feed. El contexto de cada entidad raíz debe tener su @language establecido en el código de idioma adecuado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en español, aunque el idioma de los subtítulos sea en inglés.
    @type Texto Obligatorio: Siempre se establece en CableOrSatelliteService.
    @id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
    @id debe cumplir con los siguientes requisitos:
    • Único a nivel global en el catálogo
    • Estático
    • Tiene el formato de identificador unificado de recursos (URI)
    Debido a que la url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id. Consulta la sección Identificador para obtener más detalles.
    name Texto Obligatorio: El nombre del servicio de TV.
    • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de varios idiomas y regiones.
    • Ten en cuenta que solo se admite un nombre por configuración regional (par de idioma-país).
    areaServed País, Estado, Ciudad o GeoShape Obligatorio: El área en la que los usuarios pueden recibir el servicio de emisión.
    provider Organization Obligatorio: El proveedor superior del servicio, si corresponde. Por ejemplo, ExampleTV es el proveedor de sus servicios regionales ExampleTV San Francisco y ExampleTV San Diego.
    provider.@id Texto Obligatorio: El ID del operador de TV.
    provider.@type Texto Obligatorio: Siempre se establece en Organization.
    identifier PropertyValue Muy recomendable ¿Por qué? - ID externo o de otro tipo que identifica a esta entidad, como un ID de TMS de Gracenote para este servicio de emisión. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.

    Ejemplos de CableOrSatellite

    Ejemplo de un servicio de cable o satélite:

    {
      "@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"
      ]
    }
    

    Ejemplo de un distribuidor virtual de programación de videos multicanal (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",
        }
      ]
    }
    

    Tabla de especificaciones de TelevisionChannel

    Propiedad Tipo esperado Descripción
    @context Texto Obligatorio: Siempre establecido en ["http://schema.org", {"@language": "xx"}]
    • Donde "xx" representa el idioma de las strings en el feed. El contexto de cada entidad raíz debe tener su @language establecido en el código de idioma adecuado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en español, aunque el idioma de los subtítulos sea en inglés.
    @type Texto Obligatorio: Siempre se establece en TelevisionChannel.
    @id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
    @id debe cumplir con los siguientes requisitos:
    • Único a nivel global en el catálogo
    • Estático
    • Tiene el formato de identificador unificado de recursos (URI)
    Debido a que la url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id. Consulta la sección Identificador para obtener más detalles.
    broadcastChannelId Texto Obligatorio: Es un identificador único por el que se puede identificar este BroadcastService como un servicio de cable, satélite o Internet TV.
    • En EE.UU., suele ser un número de TV por cable o satelital.
    • Para un servicio de TV por Internet (por ejemplo, un vMVPD), proporciona el nombre del canal.
    channelOrder Número Obligatorio para Google TV; de lo contrario, es opcional: Usa esta propiedad para indicar el orden en el que se deben mostrar los canales en la guía de programación electrónica para las integraciones de Google TV.

    Los channelOrder deben ser únicos en todos los canales del feed y, en el mejor de los casos, deben comenzar desde 1. channelOrder no puede tener un valor negativo o 0.
    broadcastServiceTier Texto Usa los siguientes valores:
    • Free para el canal que no requiere suscripciones.
    • Standard para los canales incluidos en una suscripción básica.
    • Premium para los canales que requieren un pago además de la suscripción básica.
    Use un array para proporcionar varios valores.
    inBroadcastLineup CableOrSatelliteService Obligatorio: Es la @id de CableOrSatelliteService que proporciona este canal a los usuarios.
    providesBroadcastService BroadcastService; Obligatorio: Es el @id de los BroadcastService cuyos programas ofrece este canal.

    Ejemplos de TelevisionChannel

    Ejemplo de un canal de TV por cable o satelital:

    {
      "@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"
      }
    }
    

    Ejemplo de un canal de TV en línea:

    {
      "@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"
      }
    }
    

    Tabla de especificaciones de la organización

    Propiedad Tipo esperado Descripción
    @context Texto Obligatorio: Siempre establecido en ["http://schema.org", {"@language": "xx"}]
    • Donde "xx" representa el idioma de las strings en el feed. El contexto de cada entidad raíz debe tener su @language establecido en el código de idioma adecuado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en español, aunque el idioma de los subtítulos sea en inglés.
    @type Texto Obligatorio: Siempre se establece en Organization.
    @id URL Obligatorio: Es el identificador del contenido en formato URI; por ejemplo, https://example.com/1234abc.
    @id debe cumplir con los siguientes requisitos:
    • Único a nivel global en el catálogo
    • Estático
    • Tiene el formato de identificador unificado de recursos (URI)
    Debido a que la url de una entidad cumple con todos los requisitos como identificador, te recomendamos que uses el url de una entidad como @id. Consulta la sección Identificador para obtener más detalles.
    name Texto Obligatorio: El nombre de la red y el operador de contenido o proveedor de contenido de TV.
    • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de varios idiomas y regiones.
    • Ten en cuenta que solo se admite un nombre por configuración regional (par de idioma-país).
    description Texto Es una descripción de la organización. con un límite de 300 caracteres. Usa un array para proporcionar las descripciones en varios idiomas o de diferentes longitudes.
    sameAs URL Muy recomendable ¿Por qué? Una URL a una página de Wikipedia que puede identificar la red de TV. Debe ser distinto de la propiedad url. Solo se completa con la página de Wikipedia que habla sobre una sola entidad de canal o red. Ten en cuenta que las páginas de Wikipedia pueden usar terminología "canal".
    potentialAction WatchAction Obligatorio si corresponde: Es obligatorio si tienes varios canales (BroadcastService) que hacen referencia a la organización. Un objeto de lenguaje de marcado de acciones que proporciona los detalles de la acción. Para obtener más información, consulta las Propiedades de lenguaje de marcado de acciones.
    url URL Indica la URL de la organización. Google usa esta URL para conciliar correctamente esta organización con la de sus bases de datos.
    identifier PropertyValue Muy recomendable ¿Por qué? - Es un ID externo o de otro tipo que identifica a esta entidad, como un ID de TMS de esta organización. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
    popularityScore Especificación de PopularityScore Muy recomendable ¿Por qué? Corresponde a una puntuación que utiliza Google, además de otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido con respecto a otro contenido de su catálogo; por lo tanto, la escala de la puntuación debe ser coherente en todos sus feeds, entre todas las entidades de su catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
    popularityScore.@type Texto Siempre establecida en PopularityScoreSpecification.
    popularityScore.value Número Un valor numérico no negativo que indica la popularidad de la entidad; una puntuación más alta significa una mayor popularidad.
    popularityScore.eligibleRegion País Regiones donde se aplica esta puntuación de popularidad. Si la puntuación de popularidad es aplicable a nivel global, configúrala en EARTH. De forma predeterminada, esta propiedad se establece en EARTH.
    Note: La popularidad específica de la configuración regional tiene prioridad sobre la popularidad global (EARTH)

    Ejemplo de organización

    {
      "@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 las siguientes páginas sobre los temas relacionados con estas propiedades: