Propiedades de lenguaje de marcado de contenido de eventos

En esta sección, se proporcionan los detalles de las propiedades de marcado de contenido para el tipo de entidad relacionada con Event.

Tabla de especificaciones de SportsEvent

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 SportsEvent.
@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 nombre de este evento.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de Varios idiomas y regiones.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
description Texto Es la descripción de este evento. Límite de 300 caracteres. Usa un array para incluir las descripciones en varios idiomas y longitudes.
sport URL Obligatorio: Es un vínculo a la página de Wikipedia (se prefiere la versión en inglés) del deporte.
startDate DateTime o Date Obligatorio: Es la hora de inicio del evento en formato ISO 8601 con zona horaria. Ten en cuenta que esta es la hora de inicio real del evento, en lugar de la hora en que se transmite en la TV.
endDate DateTime o Date Es la hora de finalización del evento en formato ISO 8601 con zona horaria.
homeTeam SportsTeam Muy recomendable ¿Por qué? Es el equipo local del evento.
homeTeam.name Texto Obligatorio Es el nombre completo del equipo deportivo.
homeTeam.sport URL Obligatorio: Es un vínculo a la página de Wikipedia (se prefiere la versión en inglés) del deporte.
homeTeam.sameAs URL Muy recomendable ¿Por qué? Es una URL a una página web de referencia que puede identificar al equipo; por ejemplo, la página de Wikipedia del equipo.
homeTeam.athlete Persona Anotaciones para un atleta individual del equipo.
homeTeam.athlete.name Texto El nombre completo del atleta
homeTeam.parentOrganization.name SportsOrganization Obligatorio Es el nombre de la liga deportiva a la que pertenece el equipo. Por ejemplo, National Basketball Association o Major League Baseball. Ten en cuenta que este campo no debe usarse para la conferencia del equipo.
homeTeam.parentOrganization.sameAs URL Muy recomendable ¿Por qué? Es la URL de una página web de referencia que puede identificar la liga del equipo; por ejemplo, la página de Wikipedia de la liga.
awayTeam SportsTeam Muy recomendable ¿Por qué? Es el equipo visitante del evento. Las propiedades son las mismas que SportsEvent.homeTeam.
competitor SportsTeam o Person Muy recomendable ¿Por qué? Si no corresponde indicar el equipo local o visitante (p.ej., un combate de boxeo o los Juegos Olímpicos), especifica a los participantes como competidores. Si es SportsTeam, las propiedades son las mismas que SportsEvent.homeTeam. Si es Person, las propiedades son las mismas que las de otros objetos Person; por ejemplo, un actor en Movie.
location Lugar O Ciudad Corresponde a la ubicación del evento.
location.name Texto Obligatorio: Es el nombre de la ubicación.
location.address PostalAddress Obligatorio si el @type de la ubicación es Place: Es la dirección de la ubicación. No se debe usar si el @type de la ubicación es City.
location.address.streetAddress Texto Es la dirección de la ubicación.
location.address.addressLocality Texto Es la ciudad de la ubicación.
location.address.addressRegion Texto Es el estado de la ubicación.
location.address.postalCode Texto Es el código postal de la ubicación.
location.address.addressCountry Texto Los países en formato ISO 3166
image ImageObject Obligatorio para Google TV: Son las imágenes relacionadas con el evento. Se recomienda que sea el póster o el banner oficial del evento. Para obtener más detalles sobre las propiedades obligatorias y opcionales que se deben incluir con image, consulta Propiedades de imagen.
potentialAction WatchAction Obligatorio si corresponde: Es el vínculo directo que reproduce la grabación de este evento deportivo en Video on Demand. Para especificar el vínculo directo de un evento en vivo, usa la propiedad publishedOn o potentialAction en BroadcastEvent.
identifier PropertyValue Muy recomendable ¿Por qué? - ID externo o algún otro ID que identifica esta entidad de forma inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades de identificador para obtener más detalles.

Ejemplos de SportsEvent

Ejemplo 1

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

Ejemplo 2

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "sport":"https://en.wikipedia.org/wiki/Boxing"
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

Tabla de especificaciones de MusicEvent

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 MusicEvent.
@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
  • En forma de identificador de recursos unificado (URI)
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 nombre de este evento.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de Varios idiomas y regiones.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
description Texto La descripción del evento. Límite de 300 caracteres. Usa un array para incluir las descripciones en varios idiomas y longitudes.
attendee Organization o Person Una persona o organización que asiste al evento.
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.
composer Organization o Person Es la persona o la organización que escribió una composición o que es el compositor de una obra interpretada en algún evento.
performer Organization o Person Obligatorio: Es un artista que participa en el evento, por ejemplo, un presentador, un músico, un grupo musical o un actor.
subEvent Evento Un evento que forma parte de este evento. Por ejemplo, un evento de conferencia incluye muchas presentaciones, cada una de las cuales es un subevento de la conferencia.
superEvent Evento Un evento del que forma parte este evento. Por ejemplo, una colección de presentaciones musicales individuales puede tener un festival de música como superEvent.
location Lugar O Ciudad Obligatorio: Es la ubicación del evento.
location.name Texto Obligatorio: Es el nombre de la ubicación.
location.address PostalAddress Obligatorio si el @type de la ubicación es Place: Es la dirección de la ubicación. No se debe usar si el atributo @type de la ubicación es City.
location.address.streetAddress Texto Es la dirección de la ubicación.
location.address.addressLocality Texto Es la ciudad de la ubicación.
location.address.addressRegion Texto Es el estado de la ubicación.
location.address.postalCode Texto Es el código postal de la ubicación.
location.address.addressCountry Texto Los países en formato ISO 3166
workPerformed CreativeWork Es una obra que se realiza en algún evento, por ejemplo, una obra de teatro que se presenta en un TheaterEvent.

Ejemplo de MusicEvent

MusicEvent

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

Tabla de especificaciones del evento

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 Event.
@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
  • En forma de identificador de recursos unificado (URI)
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 nombre de este evento.
  • Usa un array para enumerar los nombres en diferentes idiomas. Consulta el ejemplo de Varios idiomas y regiones.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
description Texto La descripción del evento. Límite de 300 caracteres. Usa un array para incluir las descripciones en varios idiomas y longitudes.
attendee Organization o Person Una persona o organización que asiste al evento.
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.
subEvent Evento Un evento que forma parte de este evento. Por ejemplo, un evento de conferencia incluye muchas presentaciones, cada una de las cuales es un subevento de la conferencia.
superEvent Evento Un evento del que forma parte este evento. Por ejemplo, una colección de presentaciones musicales individuales puede tener un festival de música como superEvent.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Muy recomendable ¿Por qué? - Se usa un PublicationEvent para especificar el lanzamiento original (global o local) de contenido por parte de un publicador, como la fecha de lanzamiento original en cines de una película.

Además, usa FeaturedEvent para indicar que tu servicio comercializa este contenido como original, destacado, especial, etcétera.

ExclusiveEvent especifica que tu servicio tiene derechos de distribución exclusivos y, además, incluye dónde y cuándo.

Consulta la sección de ejemplos para obtener detalles y ejemplos.
releasedEvent.@type Texto Obligatorio: Asegúrate de configurar esta propiedad siempre en una de las siguientes opciones:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location País Obligatorio: Son las regiones asociadas con este evento.

Para un PublicationEvent, esta es la región en la que se publicó el contenido.

Para FeaturedEvent y ExclusiveEvent, esta es la región en la que el contenido es destacado o exclusivo.

Usa los códigos ISO 3166 para los países. Para indicar todos los lugares del mundo, configúralo como EARTH.
releasedEvent.startDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent: Es la fecha de inicio de la publicación de la entidad.

En el caso de un PublicationEvent, indica la fecha de lanzamiento inicial de esta entidad, como la fecha en que una película se estrenó por primera vez en cines.

En el caso de ExclusiveEvent y FeaturedEvent, representa la fecha de inicio en la que la entidad es exclusiva o destacada.
releasedEvent.endDate Date o DateTime Recomendado: Obligatorio para ExclusiveEvent: Solo se aplica a los tipos ExclusiveEvent y FeaturedEvent.

En el caso de ExclusiveEvent, representa la fecha en la que vencen los derechos del contenido.

En el caso de FeaturedEvent, representa la última fecha en la que el proveedor destacó la entidad.

Si el contenido es exclusivo o destacado de forma perpetua, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organization o Person Opcional: Es la organización o persona que publicó esta entidad.
location Lugar O Ciudad Obligatorio: Es la ubicación del evento. Ten en cuenta que puedes proporcionar Place en el nivel City.
location.name Texto Obligatorio: Es el nombre de la ubicación.
location.address PostalAddress Obligatorio si el @type de la ubicación es Place: Es la dirección de la ubicación. No se debe usar si el @type de la ubicación es City.
location.address.streetAddress Texto Es la dirección de la ubicación.
location.address.addressLocality Texto Es la ciudad de la ubicación.
location.address.addressRegion Texto Es el estado de la ubicación.
location.address.postalCode Texto Es el código postal de la ubicación.
location.address.addressCountry Texto Los países en formato ISO 3166
workPerformed CreativeWork Es una obra que se realiza en algún evento, por ejemplo, una obra de teatro que se presenta en un TheaterEvent.

Ejemplo de evento

Evento

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}