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 Event.

Tabla de especificaciones de SportsEvent

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se debe establecer 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 debe establecer en SportsEvent.
@id URL Obligatorio: Es el identificador del contenido en formato de URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser ú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 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 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 varias regiones y varios idiomas.
  • 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: 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, no la hora en que se transmite por TV.
endDate DateTime o Date Hora de finalización del evento en formato ISO 8601 con zona horaria.
homeTeam SportsTeam Muy recomendada ¿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 recomendada ¿Por qué? Es la URL de 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 Es 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, la Asociación Nacional de Baloncesto o las Grandes Ligas de Béisbol. Ten en cuenta que este campo no se debe usar para la conferencia del equipo.
homeTeam.parentOrganization.sameAs URL Muy recomendada ¿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 recomendada ¿Por qué? Es el equipo visitante del evento. Las propiedades son las mismas que las de SportsEvent.homeTeam.
competitor SportsTeam o Person Muy recomendada ¿Por qué? Si el equipo local o visitante no es aplicable (p.ej., en un combate de boxeo o en los Juegos Olímpicos), especifica a los participantes como competidores. Si es SportsTeam, las propiedades son las mismas que las de 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 @type de ubicación es Place: Es la dirección de la ubicación. No se debe usar si @type de ubicación es Ciudad.
location.address.streetAddress Texto 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 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 arte oficial del póster o banner del evento. Para obtener más detalles 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 de un evento en vivo, usa la propiedad publishedOn o potentialAction en BroadcastEvent.
identifier PropertyValue Muy recomendada ¿Por qué? - ID externo o de otro tipo que identifica esta entidad de manera inequívoca. Se permiten varios identificadores. Consulta la sección Propiedades del identificador para obtener más detalles.

Ejemplos de SportsEvent

Ejemplo de deporte en equipo 

{
  "@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 de deportes individuales 

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

SportsEvent con restricciones de GeoShape

{
  "@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"
    }
  ]
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          http://schema.googleapis.com/GoogleVideoCast
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "free",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
       "eligibleRegion": [{
          "@type": "GeoShape",
          "@id": "http://example.com/area1",
          "addressCountry": "US",
          "postalCode": [
            "94118",
            "94119"
            ]
          },
          {
          "@type": "GeoShape",
          "@id": "http://example.com/area2",
          "addressCountry": "US",
          "postalCode": [
            "94120",
            "94121"
            ]
          },
        ]
      }
    }
  ]
}

Tabla de especificaciones de MusicEvent

Propiedad Tipo esperado Descripción
@context Texto Obligatorio: Siempre se debe establecer 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 debe establecer en MusicEvent.
@id URL Obligatorio: Es el identificador del contenido en formato de URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en todo tu catálogo.
  • Estática
  • 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 varias regiones y varios idiomas.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
description Texto Es 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 Es una persona u organización que asiste al evento.
startDate Fecha Obligatorio: Hora de inicio del evento en formato ISO 8601 con zona horaria.
endDate Fecha Hora de finalización del evento en formato ISO 8601 con zona horaria.
composer Organization o Person Es la persona u 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 Es 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 interpretaciones musicales individuales podría tener un festival de música como su superEvento.
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 @type de 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 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 Países en formato ISO 3166.
workPerformed CreativeWork Obra que se realiza en algún evento, por ejemplo, una obra de teatro que se realiza 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 debe establecer 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 debe establecer en Event.
@id URL Obligatorio: Es el identificador del contenido en formato de URI; por ejemplo, https://example.com/1234abc.
@id debe cumplir con los siguientes requisitos:
  • Debe ser único a nivel global en todo tu catálogo.
  • Estática
  • 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 varias regiones y varios idiomas.
  • Ten en cuenta que solo se admite un nombre por configuración regional (par idioma-país).
description Texto Es 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 Es una persona u organización que asiste al evento.
startDate Fecha Obligatorio: Hora de inicio del evento en formato ISO 8601 con zona horaria.
endDate Fecha Hora de finalización del evento en formato ISO 8601 con zona horaria.
subEvent Evento Es 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 interpretaciones musicales individuales podría tener un festival de música como su superEvento.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Muy recomendada ¿Por qué? - Se usa PublicationEvent para especificar el lanzamiento original (global o local) del contenido por parte de un editor, 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 dónde y cuándo.

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

En el caso de PublicationEvent, es la región en la que se publicó el contenido.

En el caso de FeaturedEvent y ExclusiveEvent, es la región en la que el contenido es destacado o exclusivo.

Usa códigos ISO 3166 para los países. Para indicar que se aplica en todo el 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 se estrenó una película en los 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 destaca la entidad.

Si el contenido es perpetuamente exclusivo o destacado, establece endDate en 20 años a partir de la fecha actual.
releasedEvent.publishedBy Organization o Person Opcional: Es la organización o la 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 @type de ubicación es Place: Es la dirección de la ubicación. No se debe usar si @type de la ubicación es City.
location.address.streetAddress Texto 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 Países en formato ISO 3166.
workPerformed CreativeWork Obra que se realiza en algún evento, por ejemplo, una obra de teatro que se realiza 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"
  }
}