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 del 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 especificación 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: 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.
name	Texto	Obligatorio: El título del programa o el evento.
description	Texto	Es la descripción del programa o el evento. Límista de 300 caracteres. Usa un array para incluir las descripciones en varios idiomas y duraciones.
startDate	Fecha	Obligatorio: Es la hora de inicio del evento en formato ISO 8601 con zona horaria.
endDate	Fecha	Indica la hora de finalización del evento en formato ISO 8601 y la zona horaria.
publishedOn	BroadcastService	Obligatorio si corresponde: Especifica la entidad BroadcastService que transmite el 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 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 tiene un @id diferente del de BroadcastEvent.
location	Text o Country	Obligatorio si BroadcastEvent es para un SportsEvent, es decir, tiene una propiedad broadcastOfEvent: El país en el que se puede transmitir el SportsEvent subyacente. Este campo puede ser una lista de países si varios de ellos pueden transmitir el SportsEvent.
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.
contentToBeAnnounced	Booleano	Obligatorio si corresponde: Usa esta propiedad si se desconoce el contenido en el momento de la creación del feed. Se establece en 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 el intervalo de tiempo. 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 en true si se trata de un evento en vivo. como un evento deportivo o un concierto.
potentialAction	WatchAction	Obligatorio si corresponde: Si el contenido se transmite como un canal menos un 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. Consulta la sección Propiedades de los identificadores 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 para los casos en los que no se hace referencia a una entidad Movie, TVSeries, TVEpisode o SportsEvent de nivel superior totalmente formada mediante 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 lo ideal sería hacer referencia con la propiedad workPerformed o broadcastOfEvent. Se prefiere TMS_ID antes que el valor TMS_ROOT_ID.
contentRating	Text o Rating	Obligatorio para el contenido para adultos; de lo contrario, se recomienda mucho ¿Por qué? - Calificación general del contenido de la transmisión. Si la clasificación del contenido se proporciona en forma de string de texto, se aceptan dos variaciones: La agencia de calificación antecede a la calificación con un espacio en blanco en el medio. Por ejemplo, un formulario "PG-13" calificación de la agencia "MPAA" debe describirse como "MPAA PG-13". Consulte 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	Organization	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.

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 mostrar 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 el contenido se transmisión 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 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 televisión Example TV(BroadcastService) está sin conexión. entre las 12:00 p.m. y las 8:00 p.m. y se transmite 1 programa llamado My favorite show entre las 8:00 a.m. p. m. y 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 obtener información sobre los temas relacionados con estas propiedades:

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