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

Tabela de especificações de SportsEvent

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Substitua xx pelo código de idioma da entidade no formato BCP 47, por exemplo, "pt".
@type Texto Obrigatório: sempre definido como SportsEvent.
@id URL Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente no seu catálogo
  • Estáticas: o ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade de URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • No formato de identificador de recurso unificado (URI)
  • O domínio usado para o valor @id precisa ser de propriedade da sua organização.
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url de uma entidade 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. Consulte o exemplo de várias regiões e idiomas.
  • Apenas um nome é aceito por localidade (par de idioma e país).
description Texto A descrição do evento. Limite de 300 caracteres. Use uma matriz para incluir as descrições em vários idiomas e comprimentos.
sport URL Obrigatório: um link para a página da Wikipédia (versão em inglês, de preferência) do esporte.
startDate DateTime ou Date Obrigatório: a hora de início do evento no formato ISO 8601 com fuso horário. Esse é o horário de início real do evento, e não o horário em que ele é transmitido na TV.
endDate DateTime ou Date A hora de término do evento no formato ISO 8601 com fuso horário.
homeTeam SportsTeam Altamente recomendado Por quê? A equipe 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 (versão em inglês, de preferência) do esporte.
homeTeam.sameAs URL Altamente recomendado Por quê? Um URL de uma página da Web de referência que pode identificar a equipe. Por exemplo, a página da Wikipédia da equipe.
homeTeam.athlete Person Anotações de um atleta individual da equipe.
homeTeam.athlete.name Texto O nome completo do atleta.
homeTeam.parentOrganization.name SportsOrganization Obrigatório: o nome da liga esportiva a que a equipe pertence. Por exemplo, National Basketball Association ou Major League Baseball. Esse campo não deve ser usado para a conferência da equipe.
homeTeam.parentOrganization.sameAs URL Altamente recomendado Por quê? Um URL de uma página da Web de referência que pode identificar a liga da equipe, por exemplo, a página da liga na Wikipédia.
awayTeam SportsTeam Altamente recomendado Por quê? A equipe visitante do evento. As propriedades são iguais a SportsEvent.homeTeam.
competitor SportsTeam ou Person Altamente recomendado Por quê? Se a equipe da casa ou visitante não for relevante (por exemplo, uma luta de boxe ou as Olimpíadas), especifique os participantes como competidores. Se SportsTeam, as propriedades são iguais a SportsEvent.homeTeam. Se Person, as propriedades são iguais às de outros objetos Person, por exemplo, um ator em Movie.
location Place OU City É o local do evento.
location.name Texto Obrigatório: o nome do local.
location.address PostalAddress Obrigatório se @type de local for "Place": o endereço do local. Não use esse valor se o @type de 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 código postal do local.
location.address.addressCountry Texto Os países no formato ISO 3166.
image ImageObject Obrigatório para o Google TV: as imagens relacionadas ao evento. Recomendado para ser o pôster ou banner oficial do evento. Para mais detalhes sobre as propriedades obrigatórias e opcionais a serem incluídas com image, consulte Propriedades de imagem.
potentialAction WatchAction Obrigatório se aplicável: o link direto que reproduz a gravação desse evento esportivo em vídeo sob demanda. Para especificar o link direto de um evento ao vivo, use a propriedade publishedOn ou potentialAction em BroadcastEvent.
identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro ID que identifica claramente esta entidade. Vários identificadores são permitidos. 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 do MusicEvent

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Substitua xx pelo código de idioma da entidade no formato BCP 47, por exemplo, "pt".
@type Texto Obrigatório: sempre definido como MusicEvent.
@id URL Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente no seu catálogo
  • Estático
  • No formato de identificador de recurso unificado (URI)
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url de uma entidade 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. Consulte o exemplo de várias regiões e idiomas.
  • Apenas um nome é aceito por localidade (par de idioma e país).
description Texto A descrição do evento. Limite de 300 caracteres. Use uma matriz para incluir as descrições em vários idiomas e comprimentos.
attendee Organization ou Person Uma pessoa ou organização que participa do evento.
startDate Data Obrigatório: a hora de início do evento no formato ISO 8601 com fuso horário.
endDate Data A hora 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 que é o compositor de uma obra apresentada em algum evento.
performer Organization ou Person Obrigatório: um artista no evento, por exemplo, um apresentador, músico, grupo musical ou ator.
subEvent Evento Um evento que faz parte deste evento. Por exemplo, um evento de conferência inclui muitas apresentações, cada uma delas é 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 superevento.
location Place OU City Obrigatório: o local do evento.
location.name Texto Obrigatório: o nome do local.
location.address PostalAddress Obrigatório se @type de local for "Place": o endereço do local. Não use esse campo 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 código postal do local.
location.address.addressCountry Texto Os países no formato ISO 3166.
workPerformed CreativeWork Uma obra apresentada em algum evento, por exemplo, uma peça em um evento de teatro.

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ção de eventos

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Substitua xx pelo código de idioma da entidade no formato BCP 47, por exemplo, "pt".
@type Texto Obrigatório: sempre definido como Event.
@id URL Obrigatório: o identificador do conteúdo em formato de URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente no seu catálogo
  • Estático
  • No formato de identificador de recurso unificado (URI)
Como o url de uma entidade atende a todos os requisitos como identificador, recomendamos que você use o url de uma entidade 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. Consulte o exemplo de várias regiões e idiomas.
  • Apenas um nome é aceito por localidade (par de idioma e país).
description Texto A descrição do evento. Limite de 300 caracteres. Use uma matriz para incluir as descrições em vários idiomas e comprimentos.
attendee Organization ou Person Uma pessoa ou organização que participa do evento.
startDate Data Obrigatório: a hora de início do evento no formato ISO 8601 com fuso horário.
endDate Data A hora de término do evento no formato ISO 8601 com fuso horário.
subEvent Evento Um evento que faz parte deste evento. Por exemplo, um evento de conferência inclui muitas apresentações, cada uma delas é 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 superevento.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Altamente recomendado Por quê? - Um PublicationEvent é usado para especificar o lançamento original (global ou local) de conteúdo por um editor, como a data de lançamento original nos cinemas 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 de distribuição exclusivos e inclui onde e quando.

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

No caso de PublicationEvent, é a região em que o conteúdo foi publicado.

No caso de FeaturedEvent e ExclusiveEvent, é a região em que o conteúdo é destaque ou exclusivo.

Use códigos ISO 3166 para países. Para indicar todos os lugares 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 um PublicationEvent, isso denota a data de lançamento inicial dessa entidade, como a data em que um filme foi lançado nos cinemas.

Para ExclusiveEvent e FeaturedEvent, isso representa a data de início em que a entidade é exclusiva ou 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 de expiração dos direitos do conteúdo.

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

Se o conteúdo for sempre exclusivo ou em destaque, defina o 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 Place OU City 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 @type de local for "Place": o endereço do local. Não use esse valor se o @type de 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 código postal do local.
location.address.addressCountry Texto Os países no formato ISO 3166.
workPerformed CreativeWork Uma obra apresentada em algum evento, por exemplo, uma peça em um evento de teatro.

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