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

En esta sección, se proporcionan los detalles de las propiedades 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 los canales de TV en vivo.

Tabla de especificaciones de BroadcastService

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se establece en ["http://schema.org", {"@language": "xx"}]
    .
  • Donde "xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es 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:
  • Debe ser único a nivel global en tu catálogo.
  • Estático: El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad url del programa). Se considerará una cadena opaca que no necesariamente debe ser un vínculo activo.
  • En forma de identificador de recursos unificado (URI)
  • El dominio que se usa para el valor @id debe ser propiedad de tu organización.
Dado que el 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 un servicio que se entrega por cable, satélite o transmisión aérea. Google usa esta URL para hacer coincidir el contenido de tu feed con el contenido de las bases de datos de Google.
url debe cumplir con los siguientes requisitos:
  • url debe ser único a nivel global
  • url debe contener una URL canónica que funcione y que Google pueda rastrear.
Para el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto destino.
name Texto Obligatorio: Es 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 idioma-país).
broadcastDisplayName Texto Obligatorio: Es el nombre visible de la cadena que los usuarios suelen ver en las guías de programas, etc. El valor puede ser el mismo que el valor del nombre.
callSign Texto La estación de radiodifusión oficial emitida por el Gobierno
inLanguage Text o Language Muy recomendable ¿Por qué? Es el idioma de transmisión principal del canal. Usa uno de los códigos de idioma del estándar IETF BCP 47.
category Texto Muy recomendable ¿Por qué? Una categoría para el artículo Se pueden usar signos mayores o barras diagonales para indicar de forma informal una jerarquía de categorías, p. ej., Deportes, Deportes > Fútbol, Noticias, Película, Música, Documental.
contentRating Text o Rating Obligatorio para un servicio de transmisión de TV solo para adultos: Es la clasificación más restrictiva para el contenido que se transmite en el canal. Si la clasificación del contenido se proporciona en forma de una cadena de texto, la agencia de clasificación debe anteponerse a la clasificación con espacios en blanco en el medio. Por ejemplo, una clasificación "TV-Y" de la agencia "TVPG" en EE.UU. se describe como "TVPG TV-Y". Consulta la lista de agencias.
contentRating.author Organization Obligatorio si contentRating usa Rating: Es el nombre de la agencia de clasificación.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: Es el valor de la calificación.
contentRating.advisoryCode Texto Es el código de advertencia para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual y V = Violencia.
description Texto Una descripción del servicio de transmisión. Tiene un límite de 300 caracteres. Usa un array para proporcionar las descripciones en varios idiomas o con diferentes longitudes.
slogan Texto Es un eslogan del servicio de transmisión.
areaServed País, Estado, Ciudad o GeoShape Obligatorio si corresponde: Es obligatorio si el cambio de canal lo realiza el proveedor de servicios de TV. Es el área en la que los usuarios pueden recibir el servicio de transmisión. Usa 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 ni Ciudad con GeoShape.
  • logo ImageObject Obligatorio si se realiza la integración con Google TV. Se recomienda en caso contrario ¿Por qué? Es una imagen que representa este servicio de transmisión.
    • Las integraciones de Google TV requieren un logotipo que se pueda usar en un fondo oscuro. Debe tener un fondo transparente con un logotipo en color o blanco que se vea claramente en un fondo oscuro.
    • La imagen del logotipo debe cumplir con una 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 píxeles o superior.
    • Usa el valor forDarkBackground para el nombre de la propiedad personalizada contentAttributes como parte de la propiedad additionalProperty para indicar el tipo de fondo en el que se debe usar el logotipo.
    • Se acepta el padding en la longitud o el ancho (pero no en ambos) si se agrega para mantener la relación de aspecto.
    • Consulta la sección Imagen para conocer otros requisitos y especificaciones.
    Consulta el ejemplo que se incluye más abajo.
    potentialAction WatchAction Obligatorio si corresponde: Es un objeto de marcado de acción que proporciona los detalles de la acción. Consulta las propiedades de marcado de acciones para obtener más detalles.
    videoFormat Texto Es 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 la resolución 2K
    • "4K" para la resolución 4K.
    • "8K" para la resolución 8K.
    broadcastTimezone Texto Es la zona horaria de este servicio de transmisión en formato IANA; por ejemplo, America/Los_Angeles. Usa un array para varias zonas horarias.
    broadcastAffiliateOf Organization Obligatorio: Es la cadena de TV que proporciona la programación de este servicio de transmisión o la organización a la que pertenece.
    broadcastAffiliateOf.@id Texto Obligatorio: Establece el valor en @id de la red de TV.
    broadcastAffiliateOf.@type Texto Obligatorio: Siempre se establece en Organization.
    identifier PropertyValue Muy recomendable ¿Por qué? - ID externo o algún otro ID que identifique esta entidad, como _PARTNER_ID_. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
    popularityScore PopularityScoreSpecification Muy recomendable ¿Por qué? Es una puntuación que Google usa, junto con otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con el resto del catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y entre todas las entidades de tu catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
    popularityScore.@type Texto Siempre se establece en PopularityScoreSpecification.
    popularityScore.value Número Es un valor numérico no negativo que indica la popularidad de la entidad. Una puntuación más alta indica una mayor popularidad.
    popularityScore.eligibleRegion País Son las regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, configúrala como 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 se establece en ["http://schema.org", {"@language": "xx"}]
      .
    • Donde "xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es 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:
    • Debe ser único a nivel global en tu catálogo.
    • Estático
    • En forma de identificador de recursos unificado (URI)
    Dado que el 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: Es 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 idioma-país).
    areaServed País, Estado, Ciudad o GeoShape Obligatorio: Es el área en la que los usuarios pueden recibir el servicio de transmisión.
    provider Organization Obligatorio: Es 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: Es el ID del operador de TV.
    provider.@type Texto Obligatorio: Siempre se establece en Organization.
    identifier PropertyValue Muy recomendable ¿Por qué? - ID externo o algún otro ID que identifique esta entidad, como un ID de TMS de Gracenote para este servicio de transmisión. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.

    Ejemplos de CableOrSatelliteService

    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 video 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 se establece en ["http://schema.org", {"@language": "xx"}]
      .
    • Donde "xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es 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:
    • Debe ser único a nivel global en tu catálogo.
    • Estático
    • En forma de identificador de recursos unificado (URI)
    Dado que el 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 a través del cual se puede identificar este BroadcastService como un servicio de TV por cable, satelital o por Internet.
    • En EE.UU., suele ser un número de TV por cable o satélite.
    • Para un servicio de TV por Internet (por ejemplo, un vMVPD), proporciona el nombre del canal.
    channelOrder Número Obligatorio para Google TV, opcional en otros casos: 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.

    El channelOrder debe ser único en todos los canales del feed y, en lo posible, debe comenzar desde 1. channelOrder no puede tener un valor negativo ni 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 adicional a la suscripción básica.
    Usa un array para proporcionar varios valores.
    inBroadcastLineup CableOrSatelliteService Obligatorio: Es el @id del CableOrSatelliteService que proporciona este canal a los usuarios.
    providesBroadcastService BroadcastService Obligatorio: Es el @id del BroadcastService cuya programación proporciona 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 se establece en ["http://schema.org", {"@language": "xx"}]
      .
    • Donde "xx" representa el idioma de las cadenas del feed. Cada contexto de entidad raíz debe tener su @language establecido en el código de idioma apropiado en formato BCP 47. Por ejemplo, si el idioma está configurado en español, se supone que los nombres están en ese idioma, incluso si el idioma de los subtítulos o la versión doblada es 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:
    • Debe ser único a nivel global en tu catálogo.
    • Estático
    • En forma de identificador de recursos unificado (URI)
    Dado que el 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: Es el nombre de la cadena de TV, el proveedor de contenido de TV o el operador 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 idioma-país).
    description Texto Una descripción de la organización Tiene un límite de 300 caracteres. Usa un array para proporcionar las descripciones en varios idiomas o con diferentes longitudes.
    sameAs URL Muy recomendable ¿Por qué? Es la URL de una página de Wikipedia que puede identificar la cadena de TV. Debe ser diferente de la propiedad url. Solo propaga páginas de Wikipedia que hablen de una sola entidad de canal o cadena. Ten en cuenta que las páginas de Wikipedia pueden usar la 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 marcado de acción que proporciona los detalles de la acción. Consulta las propiedades de marcado de acciones para obtener más detalles.
    url URL Indica la URL de la organización. Google usa esta URL para conciliar con precisión esta organización con la que se encuentra en las bases de datos de Google.
    identifier PropertyValue Muy recomendable ¿Por qué? - Un ID externo o algún otro ID que identifique esta entidad, como un ID de TMS para esta organización Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.
    popularityScore PopularityScoreSpecification Muy recomendable ¿Por qué? Es una puntuación que Google usa, junto con otros indicadores, para determinar qué contenido multimedia reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con el resto del catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y entre todas las entidades de tu catálogo. De forma predeterminada, la puntuación de popularidad de una entidad se establece en 0.
    popularityScore.@type Texto Siempre se establece en PopularityScoreSpecification.
    popularityScore.value Número Es un valor numérico no negativo que indica la popularidad de la entidad. Una puntuación más alta indica una mayor popularidad.
    popularityScore.eligibleRegion País Son las regiones en las que se aplica esta puntuación de popularidad. Si la puntuación de popularidad se aplica a nivel global, configúrala como 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 para ver los temas relacionados con estas propiedades: