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 lenguaje de marcado del contenido para los tipos de entidad BroadcastService, CableOrSatelliteService, TelevisionChannel y Organization. Para comprender mejor la relación entre estos tipos, revisa los conceptos de Canales de LiveTV.

Tabla de especificación 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 configurado con 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, incluso si el idioma de los subtítulos o doblaje está 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 todo tu catálogo
  • Estático; El ID debe ser estable y no cambiar con el tiempo (incluso si cambia la propiedad de URL del programa). Se considerará como una cadena opaca que no necesariamente debe ser un vínculo activo.
  • Con el formato de un identificador de recursos unificado (URI)
  • El dominio para el valor @id debe ser propiedad de tu organización.
Debido a 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 información.
url URL Obligatorio si corresponde: Es la URL canónica del servicio de transmisión si el canal se puede ver en Internet. Esto es opcional para los servicios que se proporcionan por cable, por satélite o por aire. Google usa esta URL para hacer coincidir el contenido de tu feed con el de las bases de datos de Google.
url debe cumplir con los siguientes requisitos:
  • El campo url debe ser único a nivel global
  • url debe contener una URL canónica que funcione y que Google pueda rastrear.
Para obtener información sobre el vínculo directo de la reproducción, consulta la propiedad urlTemplate del objeto objetivo.
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 y 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 del nombre.
callSign Texto Indica la sigla de identificación oficial emitida por el Gobierno del servicio de transmisión.
inLanguage Texto o Idioma altamente recomendado ¿Por qué? Es el idioma principal de transmisión del canal. Usa uno de los códigos de idioma del estándar IETF BCP 47.
category Texto altamente recomendado ¿Por qué? Es una categoría para el artículo. Los signos más grandes o las barras diagonales se pueden usar para indicar informalmente una jerarquía de categorías. p. ej., Deportes, Deportes > Fútbol, noticias, películas, música, documentales.
contentRating Text o Rating Obligatorio para un servicio de transmisión de TV solo para adultos: Es la clasificación más restrictiva para la transmisión del contenido en el canal. Si la clasificación del contenido se proporciona en forma de cadena de texto, se debe anteponer un espacio en blanco a la calificación antes de la calificación. por ejemplo, "TV-Y" calificación 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: Es el nombre de la agencia de calificación.
contentRating.ratingValue Texto Obligatorio si contentRating usa Rating: El valor de la calificación.
contentRating.advisoryCode Texto Es el código de asesoría del contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia de fantasía, L = Idioma, S = Contenido sexual, V = Violencia.
description Texto Es una descripción del servicio de transmisión. Límite de 300 caracteres. Usa un array para proporcionar las descripciones en varios idiomas o en diferentes longitudes.
slogan Texto Es un eslogan del servicio de transmisión.
areaServed Country, State, City o GeoShape Obligatorio si corresponde: Este campo es obligatorio si el proveedor de servicios de TV lo realiza el cambio de canal. El área en la que los usuarios recibirán 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 Country, State, City con GeoShape.
  • logo ImageObject Obligatorio si se integra con Google TV. altamente recomendado; de lo contrario, ¿Por qué? 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 tener una relación de aspecto de 1:1, 4:3 o 16:9 (en ese orden de preferencia) y una resolución de 80 × 80 px 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 relleno de longitud o ancho (pero no ambos) si se agrega para mantener la relación de aspecto.
    • Consulta la sección Imágenes para conocer otros requisitos y especificaciones.
    Consulta el ejemplo a continuación.
    potentialAction WatchAction Obligatorio si corresponde: 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 marcado de acciones.
    videoFormat Texto Es la definición de mayor calidad admitida en este servicio de transmisión. por ejemplo,
    • “SD” para la definición estándar.
    • “HD” para la alta definición.
    • “2,000” para resolución 2K.
    • "4K" para resolución 4K.
    • “8K” para resolución 8K.
    broadcastTimezone Texto La zona horaria de este servicio de transmisión en formato IANA. por ejemplo, America/Los_Angeles. Usar un array para varias zonas horarias
    broadcastAffiliateOf Organization Obligatorio: Es la cadena de TV que ofrece la programación de este servicio de emisión o la organización a la que pertenece este servicio.
    broadcastAffiliateOf.@id Texto Obligatorio: Se establece en el @id de la red de TV.
    broadcastAffiliateOf.@type Texto Obligatorio: Siempre se establece en Organization.
    identifier PropertyValue altamente recomendado ¿Por qué? - ID externo o de otro tipo que identifique a esta entidad, como _PARTNER_ID_ Se permiten múltiples identificadores. Consulta la sección Propiedades de los identificadores para obtener más detalles.
    popularityScore PopularityScoreSpecification altamente recomendado ¿Por qué? Es una puntuación que Google utiliza, junto con otros indicadores, para determinar qué contenido multimedia se debe reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con otro contenido de tu catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y en 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 significa 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 puede aplicar a nivel global, establécela 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 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 configurado con 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, incluso si el idioma de los subtítulos o doblaje está en inglés.
    @type Texto Obligatorio: Siempre se establece en CableOrSatelliteService.
    @id URL Obligatorio: 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 todo tu catálogo
    • Estático
    • Con el formato de un identificador de recursos unificado (URI)
    Debido a 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 información.
    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 y país).
    areaServed Country, State, City o GeoShape Obligatorio: El área en la que los usuarios esperan 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: El ID del operador de TV.
    provider.@type Texto Obligatorio: Siempre se establece en Organization.
    identifier PropertyValue altamente recomendado ¿Por qué? - ID externo o de otro tipo que identifique a esta entidad, como un ID de TMS de Gracenote para este servicio de transmisión Se permiten múltiples identificadores. Consulta la sección Propiedades de los identificadores 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 configurado con 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, incluso si el idioma de los subtítulos o doblaje está en inglés.
    @type Texto Obligatorio: Siempre se establece en TelevisionChannel.
    @id URL Obligatorio: 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 todo tu catálogo
    • Estático
    • Con el formato de un identificador de recursos unificado (URI)
    Debido a 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 información.
    broadcastChannelId Texto Obligatorio: Es un identificador único mediante el cual se puede identificar este BroadcastService como un servicio de cable, satélite o TV por Internet.
    • En EE.UU., suele ser un número para la TV por cable o satelital.
    • Para un servicio de TV por Internet (por ejemplo, vMVPD), proporciona el nombre del canal.
    channelOrder Número Obligatorio para GoogleTV; de lo contrario, es opcional: Utiliza esta propiedad para indicar el orden en el que se deben mostrar los canales en la guía de programación electrónica para integraciones de Google TV.

    La channelOrder debe ser única en todos los canales del feed. Idealmente, debería 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 con la suscripción básica.
    • Premium para los canales que requieren un pago además de la suscripción básica.
    Usa un array para proporcionar múltiples valores.
    inBroadcastLineup CableOrSatelliteService Obligatorio: El @id de CableOrSatelliteService que proporciona este canal a los usuarios.
    providesBroadcastService BroadcastService Obligatorio: El @id de BroadcastService cuya programación proporciona este canal.

    Ejemplos de TelevisionChannel

    Ejemplo de un canal de TV satelital o por cable:

    {
      "@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 configurado con 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, incluso si el idioma de los subtítulos o doblaje está en inglés.
    @type Texto Obligatorio: Siempre se establece en Organization.
    @id URL Obligatorio: 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 todo tu catálogo
    • Estático
    • Con el formato de un identificador de recursos unificado (URI)
    Debido a 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 información.
    name Texto Obligatorio: El nombre de la red 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 de idioma y país).
    description Texto Es una descripción de la organización. Límite de 300 caracteres. Usa un array para proporcionar las descripciones en varios idiomas o en diferentes longitudes.
    sameAs URL altamente recomendado ¿Por qué? Una URL a una página de Wikipedia que pueda identificar la red de TV. Debe ser distinta de la propiedad de URL. Solo se completa con la página de Wikipedia que trate sobre un único canal o entidad de red. Ten en cuenta que las páginas de Wikipedia pueden usar la terminología "canal".
    potentialAction WatchAction Obligatorio si corresponde: Este paso 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 marcado de acciones.
    url URL Indica la URL de la organización. Google usa esta URL para conciliar con precisión esta organización con la de las bases de datos de Google.
    identifier PropertyValue altamente recomendado ¿Por qué? - ID externo o de otro tipo que identifique a esta entidad, como un ID de TMS de esta organización Se permiten múltiples identificadores. Consulta la sección Propiedades de los identificadores para obtener más detalles.
    popularityScore PopularityScoreSpecification altamente recomendado ¿Por qué? Es una puntuación que Google utiliza, junto con otros indicadores, para determinar qué contenido multimedia se debe reproducir para los usuarios. Esta puntuación representa la popularidad del contenido en relación con otro contenido de tu catálogo. Por lo tanto, la escala de la puntuación debe ser coherente en todos tus feeds y en 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 significa 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 puede aplicar a nivel global, establécela 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 para obtener información sobre los temas relacionados con estas propiedades: