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 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, "es".
@type Texto Obligatorio: Siempre se establece en BroadcastEvent.
@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.
name Texto Obligatorio: Es el título del programa o evento.
description Texto Es la descripción del programa o evento. Límite de 300 caracteres. Usa un array para incluir las descripciones en varios idiomas y longitudes.
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 a 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 entidades: 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:
  • Para 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 Text o Country Obligatorio si BroadcastEvent es para un SportsEvent, es decir, si 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 evento deportivo.
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.
contentToBeAnnounced Booleano Obligatorio si corresponde: Usa esta propiedad si el contenido es desconocido en el momento de crear el feed.

Establece el valor en true cuando el proveedor no tenga información actualizada sobre lo que se transmitirá, false de lo contrario.
Se recomienda que una entidad BroadcastEvent incluya al menos una de las siguientes opciones:
  • 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: Usa esta propiedad si no hay una transmisión de contenido planificada para el horario.
Se recomienda que una entidad BroadcastEvent incluya al menos una de las siguientes opciones:
  • 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 en true si se trata de un evento en vivo, por ejemplo, un evento deportivo o un concierto.
potentialAction WatchAction Obligatorio si corresponde: Si el contenido se transmite como un evento de transmisión en vivo sin canal (con contentToBeAnnounced establecido en false o offAir establecido en false) , usa esta propiedad para proporcionar el vínculo directo del evento.
identifier PropertyValue Es el ID externo que identifica el contenido de la transmisión. Consulta la sección Propiedades de 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 hace 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 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 Text o Rating Obligatorio para el contenido para adultos, muy recomendable en otros casos ¿Por qué? - Clasificación general del contenido de la transmisión. Si la clasificación del contenido se proporciona en forma de una cadena de texto, se aceptan dos variaciones:
  • La agencia de calificación se agrega al principio de la calificación con un espacio en blanco en el medio. 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" (sin distinción entre mayúsculas y 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 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.

Ejemplos

Un episodio de TV se transmite en la cadena de televisión Example TV (BroadcastService) entre las 9 p.m. y las 9:30 p.m. el 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 cadena 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 crear el feed:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "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) no está en emisión entre las 12 p.m. y las 8 p.m. y transmite 1 programa llamado My favorite show entre las 8 p.m. y las 12 p.m.:

BroadcastEvent 

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "BroadcastEvent",
   "@id": "http://example.com/randomUniqueEventId1",
   "name": “Off Air”,
   "startDate": "2019-10-12T00: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/randomUniqueEventId2",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "name": "My favorite show",
  "workPerformed": {
    ...
  },
  "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 ver los temas relacionados con estas propiedades: