Se usó la API de Cloud Translation para traducir esta página.

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 especificar 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 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 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 que se interpretó 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 @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 de la exclusividad o la publicación destacada 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 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"
  }
}