Propiedades de lenguaje de marcado de contenido de eventos

En esta sección, se proporcionan los detalles de las propiedades de lenguaje de marcado de contenido para el tipo de entidad relacionado 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, "en".
@type Texto Obligatorio: Siempre se establece como 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:
  • Ú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 nombre del 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 de idioma y país).
description Texto La descripción de este evento. Limista de 300 caracteres Usa un array para incluir las descripciones en varios idiomas y longitudes.
sport URL Obligatorio Un vínculo a la página de Wikipedia (se prefiere la versión en inglés) sobre el deporte.
startDate DateTime o Date Obligatorio: Es la hora de inicio del evento en formato ISO 8601 con la zona horaria. Ten en cuenta que esta es la hora de inicio real del evento y no la hora de emisión del evento por TV.
endDate DateTime o Date Indica la hora de finalización del evento en formato ISO 8601 con la zona horaria.
homeTeam SportsTeam Recomendación: ¿Por qué? El equipo local del evento.
homeTeam.name Texto Obligatorio: Es el nombre completo del equipo deportivo.
homeTeam.sport URL Obligatorio Un vínculo a la página de Wikipedia (se prefiere la versión en inglés) sobre el deporte.
homeTeam.sameAs URL Recomendación: ¿Por qué? Una URL a una página web de referencia que pueda identificar al equipo; por ejemplo, la página de Wikipedia del equipo.
homeTeam.athlete Person Anotaciones de 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 de la que forma parte 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 Recomendación: ¿Por qué? Una URL a 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 Recomendación: ¿Por qué? El equipo de exploración del evento. Las propiedades son las mismas que SportsEvent.homeTeam.
competitor SportsTeam o Person Recomendación: ¿Por qué? Si el equipo local o visitante no es aplicable (p.ej., un partido 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 iguales a 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 la ubicación @type es Place: Es la dirección de la ubicación. No se debe usar si la ubicación @type es Ciudad.
location.address.streetAddress Texto Es la dirección de la ubicación.
location.address.addressLocality Texto La ciudad de la ubicación.
location.address.addressRegion Texto El estado de la ubicación.
location.address.postalCode Texto Es el código postal de la ubicación.
location.address.addressCountry Texto Indica los países en formato ISO 3166.
image ImageObject Obligatorio para Google TV: Las imágenes relacionadas con el evento. Se recomienda ser el afiche oficial o el arte del banner del evento. Para obtener más información sobre las propiedades obligatorias y opcionales que se deben incluir con image, consulta Propiedades de la 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 a un evento en vivo, usa la propiedad publishedOn o potentialAction en BroadcastEvent.
identifier PropertyValue Recomendación: ¿Por qué? - Es un ID externo o de otro tipo que identifica la entidad de manera inequívoca. Se permiten múltiples identificadores. Para obtener más información, consulta la sección Propiedades del identificador.

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, "en".
@type Texto Obligatorio: Siempre se establece como 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:
  • Ú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. Para obtener más información, consulta la sección Identificador.
name Texto Obligatorio: Es el nombre del 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 de idioma y país).
description Texto La descripción del evento. Limista de 300 caracteres Usa un array para incluir las descripciones en varios idiomas y longitudes.
attendee Organization o Person Una persona u organización que asistirá al evento.
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.
composer Organization o Person Es la persona u organización que escribió una composición o quien es el compositor de una obra interpretada en algún evento.
performer Organization o Person Obligatorio: Un artista 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 Es un evento del que forma parte este evento. Por ejemplo, una colección de presentaciones musicales individuales podría tener un festival de música como su superevento.
location Lugar O Ciudad Obligatorio: La ubicación del evento.
location.name Texto Obligatorio: Es el nombre de la ubicación.
location.address PostalAddress Obligatorio si la ubicación @type es Place: Es la dirección de la ubicación. No se debe usar si la ubicación @type es Ciudad.
location.address.streetAddress Texto Es la dirección de la ubicación.
location.address.addressLocality Texto La ciudad de la ubicación.
location.address.addressRegion Texto El estado de la ubicación.
location.address.postalCode Texto Es el código postal de la ubicación.
location.address.addressCountry Texto Indica los países en formato ISO 3166.
workPerformed CreativeWork Es una obra realizada en algún evento, por ejemplo, una obra representada 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 de eventos

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 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:
  • Ú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. Para obtener más información, consulta la sección Identificador.
name Texto Obligatorio: Es el nombre del 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 de idioma y país).
description Texto La descripción del evento. Limista de 300 caracteres Usa un array para incluir las descripciones en varios idiomas y longitudes.
attendee Organization o Person Una persona u organización que asistirá al evento.
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.
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 Es un evento del que forma parte este evento. Por ejemplo, una colección de presentaciones musicales individuales podría tener un festival de música como su superevento.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Recomendación: ¿Por qué? - Un PublicationEvent se usa para especificar el lanzamiento original (global o local) del contenido de un editor, como la fecha de estreno en cines original de una película.

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

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

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

En el caso de un objeto PublicationEvent, corresponde a la región en la que se publicó el contenido.

En FeaturedEvent y ExclusiveEvent, corresponde a la región en la que se destaca o se excluye el contenido.

Usa códigos ISO 3166 para los países. Para indicar cualquier lugar 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 del PublicationEvent, indica la fecha de lanzamiento inicial de esta entidad, como la fecha de estreno en cines de una película.

En 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 presenta la entidad.

Si el contenido es exclusivo o se destaca de forma permanente, 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: 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 la ubicación @type es Place: Es la dirección de la ubicación. No se debe usar si la ubicación @type es Ciudad.
location.address.streetAddress Texto Es la dirección de la ubicación.
location.address.addressLocality Texto La ciudad de la ubicación.
location.address.addressRegion Texto El estado de la ubicación.
location.address.postalCode Texto Es el código postal de la ubicación.
location.address.addressCountry Texto Indica los países en formato ISO 3166.
workPerformed CreativeWork Es una obra realizada en algún evento, por ejemplo, una obra representada 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"
  }
}