O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

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

Nesta seção, detalhamos as propriedades de marcação de conteúdo para o tipo de entidade relacionada 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, "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: Globalmente exclusivo em todo o catálogo (e diferente do `@id` de qualquer `BroadcastEvent` que faça referência a esse `SportsEvent`) Estático: o ID precisa ser estável e não pode mudar ao longo do tempo. Ele será tratado como uma string opaca e não precisa ser um link funcional. Na forma de identificador de recurso unificado (URI) O domínio usado para o valor `@id` precisa ser de propriedade da organização. Importante: não inclua uma propriedade `url` em `SportsEvent` ou `BroadcastEvent`. Forneça links de reprodução usando `SportsEvent.potentialAction`. 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 Várias regiões e idiomas. Só é possível usar um nome por localidade (par de idioma e país).
`description`	Texto	A descrição do evento. Limite de 300 caracteres. Use uma matriz para incluir descrições em vários idiomas (uma por idioma).
`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. Esse é o horário de início real do evento, não quando ele é transmitido na TV.
`endDate`	DateTime ou Date	Recomendado: o horário de término programado do evento no formato ISO 8601 com fuso horário. Informe o horário de término programado sempre que souber. Se o horário de término for desconhecido, omita essa propriedade em vez de fornecer um marcador de posição estimado.
`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 (preferencialmente em inglês) do esporte.
`homeTeam.sameAs`	URL	Altamente recomendado Por quê? É o URL de uma página da Web de referência que identifica o time, por exemplo, a página da Wikipédia do time.
`homeTeam.athlete`	Person	Anotações para um atleta individual da equipe.
`homeTeam.athlete.name`	Texto	O nome completo do atleta.
`homeTeam.parentOrganization`	SportsOrganization	Obrigatório: a liga esportiva ou organização governamental a que o time pertence. Inclua `parentOrganization` em `homeTeam` e `awayTeam` quando as duas equipes forem fornecidas.
`homeTeam.parentOrganization.name`	Texto	Obrigatório: o nome da liga esportiva de que o time faz parte. 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 link para a página da Wikipédia (preferencialmente em inglês) que identifica a liga do time (por exemplo, `https://en.wikipedia.org/wiki/National_Basketball_Association`). Não use URLs de marcador de posição `example.com`.
`awayTeam`	SportsTeam	Altamente recomendado Por quê? - O time visitante do evento. As propriedades e os requisitos (incluindo `parentOrganization`) são os mesmos de `SportsEvent.homeTeam`.
`competitor`	SportsTeam ou Person	Altamente recomendado Por quê? Se não houver um time da casa ou visitante (por exemplo, em uma luta de boxe ou nas Olimpíadas), especifique os participantes como concorrentes. Se `SportsTeam`, as propriedades serão as mesmas que `SportsEvent.homeTeam`. Se for `Person`, as propriedades serão as mesmas de outros objetos `Person`, por exemplo, um ator em `Movie`.
`location`	Local 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 use essa propriedade 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.
`image`	ImageObject	Obrigatório para o Google TV: as imagens relacionadas ao evento. Recomendado para ser o pôster oficial ou a arte do banner 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: links diretos para reproduzir o evento esportivo, usados para transmissões ao vivo sem canal e reprises de vídeo on demand. Todos os links diretos de eventos esportivos precisam estar em `SportsEvent.potentialAction`. Nunca coloque `potentialAction` em um `BroadcastEvent` que faça referência a um `SportsEvent`. Para transmissões de canais de TV linear sem um link direto de evento, forneça o link direto do canal em `BroadcastService.potentialAction`. Forneça uma matriz de objetos `WatchAction` ao oferecer várias transmissões (como transmissões regionais, domésticas ou externas ou multilíngues) ou separe as janelas de repetição ao vivo e de vídeo on demand.
`potentialAction.actionAccessibilityRequirement`	ActionAccessSpecification	Obrigatório se `potentialAction` for fornecido: define o direito de acesso e o período de disponibilidade clicável (`availabilityStarts` e `availabilityEnds`) para cada `WatchAction`: Janela contínua (`availabilityStarts`): para transmissões de esportes ao vivo, defina `availabilityStarts` pelo menos 14 dias antes de `SportsEvent.startDate` (`availabilityStarts <= SportsEvent.startDate - 14 days`) para que os blocos de eventos futuros possam aparecer com antecedência. A entidade do evento em si pode ser entregue mais perto do dia do jogo, desde que a marcação de tempo `availabilityStarts` seja pelo menos 14 dias antes de `startDate`. Buffer de prorrogação (`availabilityEnds`): defina `availabilityEnds` após `SportsEvent.endDate` com um buffer de pelo menos 2 a 3 horas (`availabilityEnds >= SportsEvent.endDate + 2 to 3 hours` ou até o final da janela de repetição de vídeo on demand) para evitar que os links diretos expirem durante prorrogações ao vivo ou cobertura pós-jogo. Consulte Propriedades de marcação de ação para mais detalhes.
`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 de esporte coletivo

{
  "@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"
    }
  ]
}

Exemplo de esportes individuais

{
  "@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 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": "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"
            ]
          }
        ]
      }
    }
  ]
}

Tabela de especificações de 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, "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 catálogo Estático Na forma de identificador de recurso unificado (URI) Como o `url` de uma entidade atende a todos os requisitos de um 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 Várias regiões e idiomas. Só é possível usar um nome 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 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 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 sendo um subEvent 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 superEvent.
`location`	Local 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. Isso 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 apresentada em um evento, por exemplo, uma peça 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 de 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 de 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 identificador de recurso unificado (URI) Como o `url` de uma entidade atende a todos os requisitos de um 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 Várias regiões e idiomas. Só é possível usar um nome 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 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 subEvent 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 superEvent.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` ou `ExclusiveEvent`	Altamente recomendado Por quê? - Um `PublicationEvent` é usado 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 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`, essa é a região em que o conteúdo foi publicado. Para `FeaturedEvent` e `ExclusiveEvent`, essa é a região em que o conteúdo é destaque ou exclusivo. Use os 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 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`. Isso se aplica apenas aos tipos `ExclusiveEvent` e `FeaturedEvent`. Para `ExclusiveEvent`, representa a data em que os direitos sobre o conteúdo expiram. Para `FeaturedEvent`, representa a última data em que o provedor destaca a entidade. Se o conteúdo for permanentemente 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 essa entidade.
`location`	Local 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 use 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 apresentada em um evento, por exemplo, uma peça 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"
  }
}