Propriedades de marcação de conteúdo de eventos

Esta seção fornece os detalhes das propriedades de marcação de conteúdo para o tipo de entidade relacionada ao Event.

Tabela de especificações de SportsEvent

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definir como ["http://schema.org", {"@language": "xx"}]
  • Substitua xx pelo código de idioma da entidade no formato formato BCP 47, por exemplo, "en".
@type Texto Obrigatório: sempre definido como SportsEvent.
@id URL Obrigatório: é o identificador do conteúdo no formato de URI, por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o seu catálogo
  • Estático: o ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade do URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • na forma de um identificador de recurso unificado (URI, na sigla em inglês);
  • O domínio usado para o valor @id precisa pertencer à sua organização.
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url dela como @id. Consulte a seção Identificador para mais detalhes.
name Texto Obrigatório: o nome do evento.
  • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo Várias regiões e idiomas.
  • Só é possível ter um nome por localidade (par de idioma e país).
description Texto A descrição deste evento. Limista de 300 caracteres. Use uma matriz para incluir as descrições em vários idiomas e tamanhos.
sport URL Obrigatório Um link para a página da Wikipédia (de preferência a versão em inglês) do esporte.
startDate DateTime ou Date Obrigatório: o horário de início do evento no formato ISO 8601 com fuso horário. Observe que este é o horário de início real do evento, e não quando o evento é transmitido na TV.
endDate DateTime ou Date É o horário de término do evento no formato ISO 8601 com fuso horário.
homeTeam SportsTeam Altamente recomendado Por quê? O time da casa do evento.
homeTeam.name Texto Obrigatório O nome completo da equipe esportiva.
homeTeam.sport URL Obrigatório Um link para a página da Wikipédia (de preferência a versão em inglês) do esporte.
homeTeam.sameAs URL Altamente recomendado Por quê? Um URL para uma página da Web de referência que pode identificar a equipe, por exemplo, a página da Wikipédia.
homeTeam.athlete Person Anotações para um atleta individual da equipe.
homeTeam.athlete.name Texto É o nome completo do atleta.
homeTeam.parentOrganization.name SportsOrganization Obrigatório Nome da liga esportiva de que a equipe faz parte. Por exemplo, "National Basketball Association" ou "Major League Baseball". Observe que esse campo não deve ser usado para a conferência da equipe.
homeTeam.parentOrganization.sameAs URL Altamente recomendado Por quê? Um URL para uma página da Web de referência que pode identificar o campeonato do time; por exemplo, a página da Wikipédia sobre o campeonato.
awayTeam SportsTeam Altamente recomendado Por quê? A equipe de exploração do evento. As propriedades são as mesmas de SportsEvent.homeTeam.
competitor SportsTeam ou Person Altamente recomendado Por quê? Se a equipe local ou ausente não for relevante (por exemplo, uma partida de boxe ou as Olimpíadas), especifique os participantes como competidores. Se for SportsTeam, as propriedades serão as mesmas de SportsEvent.homeTeam. Se for Person, as propriedades serão as mesmas de outros objetos Person. Por exemplo, um ator em Movie.
location Lugar OU Cidade É o local do evento.
location.name Texto Obrigatório: o nome do local.
location.address PostalAddress Obrigatório se o @type do local for Place: o endereço do local. Não deve ser usado se o local @type for Cidade
location.address.streetAddress Texto O endereço do local.
location.address.addressLocality Texto A cidade do local.
location.address.addressRegion Texto O estado do local.
location.address.postalCode Texto O CEP do local.
location.address.addressCountry Texto São os países no formato ISO 3166.
image ImageObject Obrigatório para o Google TV: são as imagens relacionadas ao evento. É recomendável ser o pôster ou a arte do banner oficial do evento. Para mais detalhes sobre as propriedades obrigatórias e opcionais para incluir com image, consulte Propriedades de imagem.
potentialAction WatchAction Obrigatório, se aplicável: é o link direto que exibe a gravação do evento esportivo em vídeo on demand. Para especificar o link direto de um evento ao vivo, use a propriedade publishedOn ou potentialAction no BroadcastEvent.
identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro ID que identifica claramente esta entidade. São permitidos vários identificadores. Consulte a seção Propriedades do identificador para mais detalhes.

Exemplos de SportsEvent

Exemplo 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"
    }
  ]
}

Exemplo 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"
    }
  }
}

Tabela de especificações MusicEvent

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definir como ["http://schema.org", {"@language": "xx"}]
  • Substitua xx pelo código de idioma da entidade no formato formato BCP 47, por exemplo, "en".
@type Texto Obrigatório: sempre definido como MusicEvent.
@id URL Obrigatório: é o identificador do conteúdo no formato de URI, por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o seu catálogo
  • Estático
  • na forma de um identificador de recurso unificado (URI, na sigla em inglês);
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url dela como @id. Consulte a seção Identificador para mais detalhes.
name Texto Obrigatório: o nome do evento.
  • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo Várias regiões e idiomas.
  • Só é possível ter um nome por localidade (par de idioma e país).
description Texto A descrição do evento. Limista de 300 caracteres. Use uma matriz para incluir as descrições em vários idiomas e tamanhos.
attendee Organization ou Person Uma pessoa ou organização participando do evento.
startDate Data Obrigatório: o horário de início do evento no formato ISO 8601 com fuso horário.
endDate Data É o horário de término do evento no formato ISO 8601 com fuso horário.
composer Organization ou Person A pessoa ou organização que escreveu uma composição ou é o compositor de uma obra apresentada em algum evento.
performer Organization ou Person Obrigatório: um artista no evento, por exemplo, um apresentador, um músico, um grupo musical ou um ator.
subEvent Evento Um evento que faz parte desse evento. Por exemplo, um evento de conferência inclui muitas apresentações, cada uma sendo um subEvento da conferência.
superEvent Evento Um evento do qual este evento faz parte. Por exemplo, uma coleção de apresentações musicais individuais pode ter um festival de música como o superevento.
location Lugar OU Cidade Obrigatório: O local do evento.
location.name Texto Obrigatório: o nome do local.
location.address PostalAddress Obrigatório se o @type do local for Place: o endereço do local. Não deve ser usado se o @type do local for Cidade.
location.address.streetAddress Texto O endereço do local.
location.address.addressLocality Texto A cidade do local.
location.address.addressRegion Texto O estado do local.
location.address.postalCode Texto O CEP do local.
location.address.addressCountry Texto São os países no formato ISO 3166.
workPerformed CreativeWork Uma obra realizada em algum evento, por exemplo, uma peça apresentada em um TheaterEvent.

Exemplo 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"
  }
}

Tabela de especificações do evento

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definir como ["http://schema.org", {"@language": "xx"}]
  • Substitua xx pelo código de idioma da entidade no formato formato BCP 47, por exemplo, "en".
@type Texto Obrigatório: sempre definido como Event.
@id URL Obrigatório: é o identificador do conteúdo no formato de URI, por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o seu catálogo
  • Estático
  • na forma de um identificador de recurso unificado (URI, na sigla em inglês);
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url dela como @id. Consulte a seção Identificador para mais detalhes.
name Texto Obrigatório: o nome do evento.
  • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo Várias regiões e idiomas.
  • Só é possível ter um nome por localidade (par de idioma e país).
description Texto A descrição do evento. Limista de 300 caracteres. Use uma matriz para incluir as descrições em vários idiomas e tamanhos.
attendee Organization ou Person Uma pessoa ou organização participando do evento.
startDate Data Obrigatório: o horário de início do evento no formato ISO 8601 com fuso horário.
endDate Data É o horário de término do evento no formato ISO 8601 com fuso horário.
subEvent Evento Um evento que faz parte desse evento. Por exemplo, um evento de conferência inclui muitas apresentações, cada uma sendo um subEvento da conferência.
superEvent Evento Um evento do qual este evento faz parte. Por exemplo, uma coleção de apresentações musicais individuais pode ter um festival de música como o superevento.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Altamente recomendado Por quê? - Uma PublicationEvent é usada para especificar o lançamento original (global ou local) do conteúdo por um editor, como a data de lançamento original de um filme.

Além disso, use FeaturedEvent para indicar que seu serviço comercializa esse conteúdo como original, em destaque, especial e assim por diante.

ExclusiveEvent especifica que seu serviço tem direitos exclusivos de distribuição e inclui onde e quando.

Consulte a seção de exemplo para mais detalhes e exemplos.
releasedEvent.@type Texto Obrigatório: sempre defina essa propriedade como uma das seguintes opções:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location País Obrigatório: região associada a este evento.

Para PublicationEvent, é a região onde o conteúdo foi publicado.

Para FeaturedEvent e ExclusiveEvent, é a região onde o conteúdo é apresentado ou é exclusivo.

Use códigos ISO 3166 para países. Para indicar em qualquer lugar do mundo, defina como EARTH.
releasedEvent.startDate Date ou DateTime Recomendado – Obrigatório para ExclusiveEvent: a data de início da publicação da entidade.

Para PublicationEvent, indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado pela primeira vez nos cinemas.

Para ExclusiveEvent e FeaturedEvent, representa a data de início de quando a entidade é exclusiva ou está em destaque.
releasedEvent.endDate Date ou DateTime Recomendado – Obrigatório para ExclusiveEvent: aplicável apenas aos tipos ExclusiveEvent e FeaturedEvent.

Para ExclusiveEvent, representa a data em que os direitos do conteúdo expiram.

Para FeaturedEvent, isso representa a última data em que o provedor apresenta a entidade.

Se o conteúdo for permanentemente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organization ou Person Opcional: é a organização ou pessoa que publicou a entidade.
location Lugar OU Cidade Obrigatório: O local do evento. É possível fornecer Place no nível City.
location.name Texto Obrigatório: o nome do local.
location.address PostalAddress Obrigatório se o @type do local for Place: o endereço do local. Não deve ser usado se o @type for "Cidade"
location.address.streetAddress Texto O endereço do local.
location.address.addressLocality Texto A cidade do local.
location.address.addressRegion Texto O estado do local.
location.address.postalCode Texto O CEP do local.
location.address.addressCountry Texto São os países no formato ISO 3166.
workPerformed CreativeWork Uma obra realizada em algum evento, por exemplo, uma peça apresentada em um TheaterEvent.

Exemplo 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"
  }
}