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 TV en vivo.

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 como 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: Ú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 tratará como una cadena opaca y no es necesario que sea un vínculo activo. En forma de identificador de recursos unificado (URI) El dominio utilizado 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. Para obtener más información, consulta la sección Identificador.
name	Texto	Obligatorio: Es el título del programa o evento.
description	Texto	La descripción del programa o evento. Limista 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 la zona horaria.
endDate	Fecha	Indica la hora de finalización del evento en formato ISO 8601 con la 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	El @id de la entidad BroadcastService que transmite este programa o evento.
workPerformed	CreativeWork	Obligatorio si corresponde: Usa esta propiedad cuando el contenido corresponda a uno de los siguientes tipos de entidades: Movie, TVSeries y TVEpisode. 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
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 corresponde a 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	El @id de la entidad del evento La entidad del evento debe existir en el feed y tiene un @id diferente del de BroadcastEvent.
location	Texto o País	Obligatorio si BroadcastEvent es para 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	La definición de calidad más alta admitida en este servicio de transmisión (por ejemplo, ). "SD" para la definición estándar. "HD" para alta definición. “2K” para resolución 2K “4K” para resolución 4K “8K” para resolución 8K
contentToBeAnnounced	Booleano	Obligatorio si corresponde: Usa esta propiedad si el contenido es desconocido en el momento de crear el feed. Se establece como true cuando el proveedor no tiene información actualizada sobre lo que se transmitirá; de lo contrario, 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: Usa esta propiedad si no hay una transmisión de contenido planificada para la franja horaria. 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 esta opción 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 canal sin evento de transmisión en vivo (con contentToBeAnnounced establecido en false o offAir establecido en false) , usa esta propiedad para proporcionar el vínculo directo del evento.
identifier	PropertyValue	ID externo que identifica el contenido de la transmisión. Para obtener más información, consulta la sección Propiedades del identificador. Nota: El tipo de entidad BroadcastEvent solo acepta valores propertyID de TMS_ID o TMS_ROOT_ID. Solo se debe proporcionar esta propiedad para casos en los que no se hace referencia a una entidad Movie, TVSeries, TVEpisode o SportsEvent de nivel superior completamente formada mediante las propiedades 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 el valor TMS_ID en lugar del valor TMS_ROOT_ID.
contentRating	Text o Rating	Obligatorio para el contenido para adultos; muy recomendable; de lo contrario, ¿Por qué? - Clasificación general del contenido de la transmisión. Si la clasificación del contenido se proporciona como una cadena de texto, se aceptarán dos variaciones: La agencia de clasificación precedió a la calificación con un espacio en blanco. Por ejemplo, la calificación "PG-13" de la agencia "MPAA" de EE.UU. debe describirse 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 calificación de la película.
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: Es el valor de la calificación.
contentRating.advisoryCode	Texto	El código de aviso para el contenido. Los valores aceptados incluyen D, FV, L, S y V. D = Diálogo, V = Violencia de fantasía, L = Idioma, S = Contenido sexual, V = Violencia.

Ejemplos

Nota: En los siguientes ejemplos, solo se muestran las entidades más relevantes para la situación que se describe en el ejemplo. Es posible que se requieran 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: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 se desconoce el contenido que se transmitirá en la red de televisión Example TV (BroadcastService) entre las 9:00 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": "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 red de televisión Example TV(BroadcastService) está sin 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"
        }
      ]
    }
  }
}

Páginas relacionadas

Consulta las siguientes páginas para conocer 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
• Recopila los metadatos de tu contenido