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

Nota: En los siguientes ejemplos, solo se muestran las entidades más relevantes para la situación que se describe. Es posible que se necesiten más entidades para representar todo el feed.

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 BroadcastService

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

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

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

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

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

}

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

Páginas relacionadas

Consulta las siguientes páginas para ver los temas relacionados con estas propiedades:

• Identifica los tipos de entidades de tu contenido
• Cómo recopilar el ID, la URL y el nombre de tu contenido
• Cómo recopilar los metadatos de tu contenido