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 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 (y distinto del @id de cualquier BroadcastEvent que haga referencia a este SportsEvent).
  • Estático: El ID debe ser fijo y mantener el mismo formato con el paso del tiempo. Se la considerará como una cadena opaca que no necesariamente debe ser un vínculo activo.
  • En forma de identificador de recursos uniforme (URI)
  • El dominio para el valor @id debe ser propiedad de tu organización.
Importante: No incluyas una propiedad url en SportsEvent ni BroadcastEvent. Proporciona vínculos de reproducción con SportsEvent.potentialAction. 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 de idioma y país).
description Texto Es la descripción de este evento. Límite de 300 caracteres. Usa un array para incluir descripciones en varios idiomas (una por idioma).
sport URL Obligatorio Un vínculo a la página de Wikipedia (preferentemente, 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, no la hora en que se transmite por TV.
endDate DateTime o Date Recomendado: Es la hora de finalización programada del evento en formato ISO 8601 con zona horaria. Proporciona la hora de finalización programada siempre que la conozcas. Si no la conoces, omite esta propiedad en lugar de proporcionar un marcador de posición estimado.
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 Un vínculo a la página de Wikipedia (preferentemente, la versión en inglés) del deporte.
homeTeam.sameAs URL Muy recomendada ¿Por qué? Es una URL que dirige a una página web de referencia que puede identificar al equipo, por ejemplo, la página de Wikipedia del equipo.
homeTeam.athlete Persona Son las anotaciones de un atleta individual del equipo.
homeTeam.athlete.name Texto Es el nombre completo del atleta.
homeTeam.parentOrganization SportsOrganization Obligatorio: Es la liga deportiva o la organización rectora a la que pertenece el equipo. Incluye parentOrganization en homeTeam y awayTeam cuando se proporcionen ambos equipos.
homeTeam.parentOrganization.name Texto 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 se debe usar para la conferencia del equipo.
homeTeam.parentOrganization.sameAs URL Muy recomendada ¿Por qué? - Un vínculo a la página de Wikipedia (preferentemente, la versión en inglés) que identifique la liga del equipo (por ejemplo, https://en.wikipedia.org/wiki/National_Basketball_Association). No uses URLs de marcador de posición example.com.
awayTeam SportsTeam Muy recomendada ¿Por qué? - El equipo visitante del evento. Las propiedades y los requisitos (incluido parentOrganization) son los mismos que los de SportsEvent.homeTeam.
competitor SportsTeam o Person Muy recomendada ¿Por qué? Si no corresponde indicar un equipo local o visitante (p.ej., en un combate de boxeo o en los Juegos Olímpicos), especifica 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 el @type de la ubicación es Place: Es la dirección de la ubicación. No se debe usar si el @type de 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 banner oficial del evento. Para obtener más detalles sobre las propiedades obligatorias y opcionales que se deben incluir en image, consulta Propiedades de imagen.
potentialAction WatchAction Obligatorio si corresponde: Son los vínculos directos para reproducir el evento deportivo, que se usan tanto para las transmisiones en vivo sin canal como para las repeticiones de videos on demand. Todos los vínculos directos de eventos deportivos deben residir en SportsEvent.potentialAction; nunca coloques potentialAction en un BroadcastEvent que haga referencia a un SportsEvent (para transmisiones de canales de TV lineales sin un vínculo directo de evento, proporciona el vínculo directo del canal en BroadcastService.potentialAction). Proporciona un array de objetos WatchAction cuando ofrezcas varias transmisiones (como transmisiones regionales, de local o visitante, o en varios idiomas) o ventanas de reproducción en vivo y de video on demand independientes.
potentialAction.actionAccessibilityRequirement ActionAccessSpecification Obligatorio si se proporciona potentialAction: Define el derecho y el período de disponibilidad en el que se puede hacer clic (availabilityStarts y availabilityEnds) para cada WatchAction:
  • Ventana de anuncios previos al video (availabilityStarts): En el caso de las transmisiones deportivas en vivo, establece availabilityStarts al menos 14 días antes de SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) para que las tarjetas de los próximos eventos puedan aparecer con anticipación (la entidad del evento en sí se puede entregar más cerca del día del partido, siempre que la marca de tiempo de availabilityStarts sea de al menos 14 días antes de startDate).
  • Margen de tiempo extra (availabilityEnds): Establece availabilityEnds después de SportsEvent.endDate con un margen de al menos 2 a 3 horas (availabilityEnds >= SportsEvent.endDate + 2 to 3 hours o hasta el final de la ventana de reproducción de video on demand) para evitar que los vínculos directos venzan durante los tiempos extra en vivo o la cobertura posterior al partido.
Consulta Propiedades de lenguaje de marcado de acciones para obtener todos los detalles.
identifier PropertyValue Muy recomendada ¿Por qué? - Es el ID externo o algún otro ID que identifica esta entidad inequívocamente. 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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ]
}

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",
  "endDate": "2019-07-12T23:30-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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?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-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform"
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "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 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 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:
  • Único a nivel global en todo tu catálogo
  • Estática
  • En forma de identificador de recursos uniforme (URI)
Como el url de una entidad cumple con todos los requisitos para ser un identificador, te recomendamos que lo uses url 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 de idioma y 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 o una 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 que se interpreta en un evento.
performer Organization o Person Obligatorio: Es un artista que se presenta 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 subEvent de la conferencia.
superEvent Evento 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 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 @type de 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 Una obra que se representa en un evento, por ejemplo, una obra de teatro que se representa 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 especificación 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 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:
  • Único a nivel global en todo tu catálogo
  • Estática
  • En forma de identificador de recursos uniforme (URI)
Como el url de una entidad cumple con todos los requisitos para ser un identificador, te recomendamos que lo uses url 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 de idioma y 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 o una 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 subEvent de la conferencia.
superEvent Evento 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 superEvent.
releasedEvent PublicationEvent, FeaturedEvent o ExclusiveEvent Muy recomendada ¿Por qué? - Se usa PublicationEvent para especificar el lanzamiento original (global o local) del contenido de un editor, como la fecha de estreno original de una película en el cine.

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 más detalles y ejemplos.
releasedEvent.@type Texto Obligatorio: Asegúrate de establecer siempre esta propiedad en uno de los siguientes valores:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location País Obligatorio: Son las regiones asociadas con este evento.

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

En el caso de 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 que se trata de 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 de la exclusividad o la publicación de la entidad.
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 que vencen los derechos sobre el contenido.

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

Si el contenido es exclusivo o destacado de forma perpetua, establece el valor de 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 a nivel de 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 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 Una obra que se representa en un evento, por ejemplo, una obra de teatro que se representa 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"
  }
}