Propiedades de lenguaje de marcado de contenido para eventos de TV en vivo

En esta sección, se proporcionan los detalles de las propiedades de lenguaje de marcado de contenido para el tipo de entidad BroadcastEvent. Para comprender mejor la relación entre estos tipos, revisa los conceptos de Eventos de LiveTV.

Tabla de especificaciones de BroadcastEvent

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se establece en ["http://schema.org", {"@language": "xx"}]
  • Reemplaza xx por el código de idioma de la entidad en formato BCP 47, por ejemplo, "en".
@type Texto Obligatorio: Siempre se establece en BroadcastEvent.
@id URL Obligatorio: Es el identificador del espacio de transmisión en formato de URI; por ejemplo, https://example.com/live/channel1/20191012T2100.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en todo tu catálogo y distinto de workPerformed.@id o broadcastOfEvent.@id (por ejemplo, incorpora el canal o servicio y la hora de inicio de la transmisión en el URI).
  • Estático: El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. Se la considerará como una cadena opaca que no necesariamente debe ser un vínculo activo.
  • En forma de identificador de recursos uniforme (URI)
  • El dominio para el valor @id debe ser propiedad de tu organización.
Importante: No incluyas una propiedad url en BroadcastEvent ni SportsEvent. Proporciona el url canónico solo en la entidad de contenido subyacente (Movie, TVSeries o TVEpisode). Consulta la sección Identificador para obtener más detalles.
name Texto Obligatorio: Es el título del programa o evento.
description Texto Es la descripción del espectáculo o evento. Límite de 300 caracteres. Usa un array para incluir descripciones en varios idiomas (una por idioma).
startDate Fecha Obligatorio: Es la hora de inicio del evento en formato ISO 8601 con zona horaria.
endDate Fecha Es la hora de finalización del evento en formato ISO 8601 con zona horaria.
publishedOn BroadcastService Obligatorio si corresponde: Especifica la entidad BroadcastService que transmite este programa o evento.

Si el contenido se transmite en un canal de TV, esta propiedad es obligatoria. Si el contenido no está asociado con ningún canal de TV, no proporciones esta propiedad.
publishedOn.@type Texto Debes establecerlo en BroadcastService.
publishedOn.@id URL Es el @id de la entidad BroadcastService que transmite este programa o evento.
workPerformed CreativeWork Obligatorio si corresponde: Usa esta propiedad cuando el contenido sea uno de los siguientes tipos de entidad: Movie, TVSeries y TVEpisode.
Se recomienda que una entidad BroadcastEvent incluya al menos uno de los siguientes elementos:
  • workPerformed
  • broadcastOfEvent
  • Se estableció true como la dirección de tu contentToBeAnnounced
  • Se estableció true como la dirección de tu offAir
workPerformed.@type Texto Se establece en Movie, TVSeries o TVEpisode.
workPerformed.@id URL Es el @id de la entidad de contenido.
broadcastOfEvent SportsEvent Obligatorio si corresponde: Usa esta propiedad si el contenido es un evento en vivo:
  • En el caso de un evento deportivo, esta propiedad debe hacer referencia a una entidad SportsEvent.

Se recomienda que una entidad BroadcastEvent incluya al menos uno de los siguientes elementos:
  • workPerformed
  • broadcastOfEvent
  • Se estableció true como la dirección de tu contentToBeAnnounced
  • Se estableció true como la dirección de tu offAir
broadcastOfEvent.@type Texto Debes establecerlo en SportsEvent.
broadcastOfEvent.@id URL Es el @id de la entidad del evento. La entidad del evento debe existir en el feed y tener un @id diferente del de BroadcastEvent.
location Texto o País Es obligatorio si BroadcastEvent es para un SportsEvent, es decir, tiene la propiedad broadcastOfEvent: Es el país en el que se puede transmitir el SportsEvent subyacente. Este campo puede ser una lista de países si varios países pueden transmitir el SportsEvent.
videoFormat Texto Es la definición de calidad más alta que se admite en 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 resolución 4K
  • "8K" para la resolución 8K
contentToBeAnnounced Booleano Obligatorio si corresponde: Usa esta propiedad si se desconoce el contenido en el momento de la creación del feed.

Establece el valor en true cuando el proveedor no tenga información actualizada sobre lo que se transmitirá; de lo contrario, establécelo en false.
Se recomienda que una entidad BroadcastEvent incluya al menos uno de los siguientes elementos:
  • workPerformed
  • broadcastOfEvent
  • Se estableció true como la dirección de tu contentToBeAnnounced
  • Se estableció true como la dirección de tu offAir
offAir Booleano Obligatorio si corresponde: Se establece en true cuando no hay contenido planificado para la transmisión en el horario de un canal de BroadcastService.
  • Establece name y description en "Off Air".
  • Cada offAir BroadcastEvent debe durar 4 horas o menos (no emitas bloques continuos de 24 horas). Cuando un canal esté fuera del aire durante más de 4 horas, emite varias entidades BroadcastEvent contiguas que no se superpongan de un máximo de 4 horas cada una para que el canal mantenga una cobertura de programación completa las 24 horas, todos los días, sin interrupciones al principio o al final de la ventana del feed.
Se recomienda que una entidad BroadcastEvent incluya al menos uno de los siguientes elementos:
  • workPerformed
  • broadcastOfEvent
  • Se estableció true como la dirección de tu contentToBeAnnounced
  • Se estableció true como la dirección de tu offAir
isLiveBroadcast Booleano Establece el valor booleano true (sin comillas) si esta emisión es una transmisión en vivo (por ejemplo, un partido de deportes en vivo o noticias diarias en vivo) o false para la programación que no es en vivo y las repeticiones.
potentialAction WatchAction Obligatorio si corresponde: Nunca proporciones potentialAction en un BroadcastEvent cuando broadcastOfEvent haga referencia a un SportsEvent (coloca todos los vínculos directos de deportes en SportsEvent.potentialAction) o cuando publishedOn haga referencia a un canal de BroadcastService (coloca los vínculos directos del canal en BroadcastService.potentialAction). Solo proporciona BroadcastEvent.potentialAction para las transmisiones en vivo sin canal que no hagan referencia a un SportsEvent (como el contenido complementario en vivo independiente con contentToBeAnnounced y offAir omitidos o false).
identifier PropertyValue Es el ID externo que identifica el contenido de la transmisión. Consulta la sección Propiedades del identificador para obtener más detalles.
  • Nota: El tipo de entidad BroadcastEvent solo acepta valores propertyID de TMS_ID o TMS_ROOT_ID.
  • Esta propiedad solo se debe proporcionar en los casos en que no se haga referencia a una entidad Movie, TVSeries, TVEpisode o SportsEvent de nivel superior completamente formada con la propiedad workPerformed o broadcastOfEvent.
  • El valor de la propiedad debe reflejar el TMS_ID o el TMS_ROOT_ID de la entidad Movie, TVSeries, TVEpisode o SportsEvent a la que, idealmente, harías referencia con la propiedad workPerformed o broadcastOfEvent.
  • Se prefiere TMS_ID en lugar del valor TMS_ROOT_ID.
contentRating Texto o Clasificación Obligatorio para el contenido para adultos y muy recomendado para el resto de los casos ¿Por qué? - Es la clasificación de contenido general del contenido de la transmisión. Si la clasificación del contenido se proporciona en forma de cadena de texto, se aceptan dos variantes:
  • La agencia de calificación se antepone a la calificación con un espacio en blanco entre ellas. Por ejemplo, una clasificación "PG-13" de la agencia "MPAA" en EE.UU. se debe describir como "MPAA PG-13". Consulta la lista de agencias.
  • Un valor de "RATING NOT KNOWN" (no distingue mayúsculas de minúsculas) para indicar que no conoces la clasificación de la película
contentRating.author Organization Obligatorio si contentRating usa Rating: Es el nombre de la agencia de calificació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 del contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, FV = Violencia fantástica, L = Lenguaje, S = Contenido sexual, V = Violencia.

Ejemplos

Un episodio de TV se transmite en la cadena de televisión Example TV (BroadcastService) entre las 9:00 p.m. y las 9:30 p.m. del 12 de octubre de 2019:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
  "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "description": "Three mice leave the town and the trip turns into something more.",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
  }
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "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"
   }
  ],
  "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",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Ejemplo que muestra el uso de la propiedad contentToBeAnnounced cuando no se conoce el contenido que se transmitirá en la red de televisión Example TV (BroadcastService) entre las 9 p.m. y las 9:30 p.m. del 12 de octubre de 2019 en el momento de la creación del feed:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "Content To Be Announced",
  "description": "Content To Be Announced",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "contentToBeAnnounced": true
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "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"
   }
  ],
  "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",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

El canal de la cadena de televisión Example TV (BroadcastService) está fuera del aire entre las 12 p.m. y las 8 p.m. (se modela como dos bloques contiguos de 4 horas de Off Air) y transmite un programa llamado My favorite show entre las 8 p.m. y las 12 a.m.:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId2",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16:00-08:00",
  "endDate": "2019-10-12T20:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  }
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "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"
   }
  ],
  "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",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Consulta las siguientes páginas para obtener información sobre los temas relacionados con estas propiedades: