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

Esta seção fornece detalhes sobre as propriedades de marcação de conteúdo para o tipo de entidade relacionada 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 do idioma da entidade no 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 URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o catálogo
  • Estático. O ID precisa ser estável e não pode ser alterado ao longo do tempo, mesmo que a propriedade "url" do programa mude. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • Na forma de um identificador uniforme de recursos (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 deste evento.
  • Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo Várias regiões e idiomas.
  • Só é possível usar um nome por localidade (par idioma-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 tamanhos.
sport URL Obrigatório: um link para a página da Wikipédia (preferencialmente 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 ele é 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 recomendável Por quê? A equipe da casa do evento.
homeTeam.name Texto Obrigatório: o nome completo do time.
homeTeam.sport URL Obrigatório: um link para a página da Wikipédia (preferencialmente em inglês) do esporte.
homeTeam.sameAs URL Altamente recomendável Por quê? É o URL de uma página da Web de referência que pode identificar o time, por exemplo, a página da Wikipédia do time.
homeTeam.athlete Person Anotações de um atleta individual na equipe.
homeTeam.athlete.name Texto O nome completo do atleta.
homeTeam.parentOrganization.name SportsOrganization Obrigatório: o nome da liga esportiva de que o time faz parte. Por exemplo, a National Basketball Association ou a Major League Baseball. Observação: este campo não deve ser usado para a videoconferência da equipe.
homeTeam.parentOrganization.sameAs URL Altamente recomendável Por quê? Um URL para uma página da Web de referência que pode identificar a liga do time, por exemplo, a página da Wikipédia da liga.
awayTeam SportsTeam Altamente recomendável Por quê? A equipe visitante do evento. As propriedades são as mesmas de SportsEvent.homeTeam.
competitor SportsTeam ou Person Altamente recomendável Por quê? Se o time da casa ou visitante não for aplicável (por exemplo, uma luta de boxe, as Olimpíadas), especifique os participantes como concorrentes. Se SportsTeam, as propriedades serão as mesmas que SportsEvent.homeTeam. Se 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 @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.
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 no 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 recomendável 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 de esporte em equipe 

{
  "@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 de esporte individual 

{
  "@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 com restrições 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"
            ]
          },
        ]
      }
    }
  ]
}

Tabela de especificação de MusicEvent

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Substitua xx pelo código do idioma da entidade no 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 URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o catálogo
  • Estático
  • Na forma de um identificador uniforme de recursos (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 deste evento.
  • Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo Várias regiões e idiomas.
  • Só é possível usar um nome por localidade (par idioma-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 tamanhos.
attendee Organization ou Person É uma pessoa ou organização que participa 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 que é o compositor de uma obra apresentada em algum evento.
performer Organization ou Person Obrigatório: um artista que se apresenta no evento, como um apresentador, um músico, um grupo musical ou um ator.
subEvent Evento Um evento que faz parte deste evento. Por exemplo, um evento de conferência inclui muitas apresentações, cada uma delas sendo um subEvento da conferência.
superEvent Evento Um evento de que este evento faz parte. Por exemplo, uma coleção de apresentações musicais individuais pode ter um festival de música como 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 código postal do local.
location.address.addressCountry Texto Os países no formato ISO 3166.
workPerformed CreativeWork Uma obra realizada em algum evento, por exemplo, uma peça teatral 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çã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 do idioma da entidade no 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 URI. Por exemplo, https://example.com/1234abc.
@id precisa atender aos seguintes requisitos:
  • Exclusivo globalmente em todo o catálogo
  • Estático
  • Na forma de um identificador uniforme de recursos (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 deste evento.
  • Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo Várias regiões e idiomas.
  • Só é possível usar um nome por localidade (par idioma-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 tamanhos.
attendee Organization ou Person É uma pessoa ou organização que participa 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 deste evento. Por exemplo, um evento de conferência inclui muitas apresentações, cada uma delas sendo um subEvento da conferência.
superEvent Evento Um evento de que 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 recomendável 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 de um filme nos cinemas.

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

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

Consulte a seção de exemplos 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: as regiões associadas a esse evento.

Para um PublicationEvent, é a região em que o conteúdo foi publicado.

Para FeaturedEvent e ExclusiveEvent, é a região em que 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 um PublicationEvent, isso indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado nos cinemas pela primeira vez.

Para ExclusiveEvent e FeaturedEvent, isso representa a data de início da exclusividade ou destaque da entidade.
releasedEvent.endDate Date ou DateTime Recomendado: obrigatório para ExclusiveEvent. Isso só se aplica aos tipos ExclusiveEvent e FeaturedEvent.

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

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

Se o conteúdo for perpetuamente 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 esta 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 do local for "City"
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 realizada em algum evento, por exemplo, uma peça teatral 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"
  }
}