Propriedades de marcação de conteúdo de programas de TV

Esta seção fornece os detalhes das propriedades de marcação de conteúdo para os tipos de entidade TVSeries, TVEpisode e TVSeason.

Fornecer TVSeason como uma entidade completa é opcional. Consulte a seção Relações de TVSeries, TVSeason e TVEpisode para saber mais.

Tabela de especificações

TVSeries

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Em que"xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma do áudio/legenda seja o inglês.
@type Texto Obrigatório: sempre definido como TVSeries.
@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
  • 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.
url URL Obrigatório: o URL canônico do conteúdo, que o Google usa para fazer a correspondência entre o conteúdo do seu feed e o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • O url precisa conter um URL canônico que funcione e que o Google possa rastrear.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto alvo.
name Texto Obrigatório: o nome do programa.
  • 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).
titleEIDR Texto Altamente recomendado Por quê? - Um identificador EIDR (registro de identificador de entretenimento) que represente, no nível mais geral/abstrato, uma obra de cinema ou televisão.

Por exemplo, o titleEIDR da série de TV "Game of Thrones" é "10.5240/C1B5-3BA1-8991-A571-8472-W".
potentialAction WatchAction Obrigatório, se aplicável: um objeto de marcação de ação que fornece os detalhes da ação.
  • Se o conteúdo estiver disponível em vídeo on demand (VOD), essa propriedade será obrigatória. O objeto de marcação de ação precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal de TV ao vivo, essa propriedade será opcional. A entidade BroadcastService associada vai fornecer o link direto do canal.
  • Um TVSeries pode estar disponível no VoD e na TV ao vivo.
Use uma matriz para especificar diferentes links diretos em várias regiões. Consulte o exemplo de várias regiões e idiomas.
sameAs URL Altamente recomendado Por quê? Um URL de uma página da Web de referência que pode identificar o programa, por exemplo, a página da Wikipédia do programa. Ele precisa ser diferente da propriedade url.
inLanguage Texto Idioma original da série no formato BCP 47.
genre Texto Uma lista ordenada de todos os gêneros relevantes. Por exemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Texto Palavras-chave ou tags usadas para descrever esse conteúdo. Uma matriz de palavras-chave também é permitida. Por exemplo, ["feature, biography"] pode ser uma matriz de palavras-chave para descrever o conteúdo.
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Altamente recomendado Por quê? - Um PublicationEvent é usado para especificar a versão original (global ou local) do conteúdo de 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 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.
description Texto Altamente recomendado Por quê? Uma sinopse do programa. As sinopses da trama são preferidas aos resumos factuais. Limite de 300 caracteres.
actor Person ou PerformingGroup ou PerformanceRole Altamente recomendado Por quê? Uma matriz dos membros do elenco da série. Confira as orientações de modelagem aqui.
director Person Altamente recomendado Por quê? Os diretores do programa.
producer Organization ou Person Altamente recomendado Por quê? Os produtores do programa.
image ImageObject Obrigatório para o Google TV: as imagens relacionadas à série de TV. Para mais detalhes sobre as propriedades obrigatórias e opcionais a serem incluídas com image, consulte Propriedades de imagem.
trailer.description Texto A descrição do trailer. Confira o exemplo de trailer.
trailer.inLanguage Texto O idioma do trailer no formato BCP 47.
trailer.url URL Um URL de um trailer hospedado publicamente e enviado por estúdios de produção ou fontes autorizadas.
trailer.regionsAllowed Place As regiões em que a mídia é permitida. Se não for especificado, será considerado que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166.
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.
popularityScore PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia será reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos no seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
popularityScore.@type Texto Sempre defina como PopularityScoreSpecification.
popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. Quanto maior a pontuação, maior a popularidade.
popularityScore.eligibleRegion País Regiões em que esse índice de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
Note: A popularidade específica da localidade tem precedência sobre a global (EARTH)
review Review (em inglês) Analisar as classificações da série de TV
review.reviewRating Classificação Obrigatório se review for fornecido. É usado para especificar a nota dada na avaliação.
contentRating Texto ou Classificação Obrigatório para conteúdo adulto, altamente recomendado para outros tipos de conteúdo: classificação geral do conteúdo. Se a classificação do conteúdo for fornecida na forma de uma string de texto, duas variações serão aceitas:
  • A agência de classificação foi adicionada à classificação com um espaço em branco no meio. Por exemplo, uma classificação "TV-MA" da agência "TVPG" nos EUA precisa ser descrita como "TVPG TV-MA". Consulte a lista de agências.
  • Um valor de "RATING NOT KNOWN" (maiúsculas e minúsculas não são diferenciadas) para indicar que você não sabe a classificação do conteúdo.
contentRating.author Organização Obrigatório se contentRating usar Rating: o nome da agência de classificação. Consulte a página Agências de classificação de conteúdo para ver uma lista das agências de classificação aceitas.
contentRating.ratingValue Texto Obrigatório se contentRating usar Rating: o valor da classificação.
contentRating.advisoryCode Texto O código de aviso do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = diálogo, FV = violência de fantasia, L = linguagem, S = conteúdo sexual, V = violência.

TVEpisode

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Em que"xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que a legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre definido como TVEpisode.
@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
  • 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.
url URL Obrigatório: o URL canônico do conteúdo, que o Google usa para fazer a correspondência entre o conteúdo do seu feed e o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • O url precisa conter um URL canônico que funcione e que o Google possa rastrear.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto alvo.
name Texto Obrigatório: o nome do episódio.
  • Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo de representação de vários idiomas.
  • Apenas um nome é aceito por localidade (par de idioma e país).
titleEIDR Texto Altamente recomendado Por quê? - Um identificador EIDR (registro de identificador de entretenimento) que represente, no nível mais geral/abstrato, uma obra de cinema ou televisão.

Por exemplo, o titleEIDR do primeiro episódio da primeira temporada da série de TV "Game of Thrones" é "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
editEIDR Texto Altamente recomendado Por quê? - Um identificador EIDR (Registro de Identificador de Entretenimento) que representa uma edição específica de um filme ou programa de TV.

Por exemplo, o primeiro episódio da primeira temporada da série de TV "Game of Thrones", cujo titleEIDR é "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", tem uma edição, por exemplo, "10.5240/FB97-C847-2969-D0AB-ECD1-C". A propriedade

titleEIDR é obrigatória quando o editEIDR é fornecido.
inLanguage Texto Idioma original da série no formato BCP 47.
episodeNumber Número inteiro Obrigatório: o número que indica a posição do episódio na ordem dos episódios de uma temporada. O episodeNumber precisa ser reiniciado para cada temporada. Ou seja, o primeiro episódio de cada temporada precisa ser 1.
partOfSeason TVSeason Obrigatório: a temporada de TV a que o episódio pertence.

Mesmo que um TVEpisode não tenha um TVSeason correspondente, ainda é necessário fornecer as propriedades partOfSeason.@id e partOfSeason.seasonNumber. Uma solução alternativa é:
  • Pegue partofSeries.@id (por exemplo, http://www.example.com/my_favorite_tv_show) e anexe um campo de consulta de marcador de posição (por exemplo, ?season1) para criar um partOfSeason.@id exclusivo (por exemplo, http://www.example.com/my_favorite_tv_show?season1).
  • Defina partOfSeason.seasonNumber como 1.
partOfSeason.@type Texto Obrigatório: sempre definido como TVSeason.
partOfSeason.@id URL Obrigatório: o @id do TVSeason a que o episódio pertence.
partOfSeason.seasonNumber Número inteiro Obrigatório: o número que indica a posição da temporada na ordem das temporadas da série de TV.
partOfSeries TVSeries Obrigatório: a série de TV a que o episódio pertence.
partOfSeries.@type Texto Obrigatório: sempre definido como TVSeries.
partOfSeries.@id URL Obrigatório: o @id do TVSeries a que o episódio pertence.
partOfSeries.name Texto Obrigatório: o nome da série de TV.
partOfSeries.sameAs Texto Um URL de uma página da Web de referência que pode identificar o programa, por exemplo, a página da Wikipédia do programa. Ele precisa ser diferente da propriedade url.
potentialAction WatchAction Obrigatório, se aplicável: um objeto de marcação de ação que fornece os detalhes da ação.
  • Se o conteúdo estiver disponível em vídeo on demand (VOD), essa propriedade será obrigatória. O objeto de marcação de ação precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal de TV ao vivo, essa propriedade será opcional. A entidade BroadcastService associada vai fornecer o link direto do canal.
  • Um TVEpisode pode estar disponível no VoD e na TV ao vivo.
Use uma matriz para especificar diferentes links diretos em várias regiões. Consulte o exemplo de várias regiões e idiomas.
sameAs Altamente recomendado Por quê? URL Um URL de uma página da Web de referência que pode identificar o episódio. Por exemplo, a página do episódio na Wikipédia. Ele precisa ser diferente da propriedade url.
duration Duração Duração do episódio no formato ISO 8601. Use o formato: "PT00H00M".
releasedEvent PublicationEvent, FeaturedEvent ou ExclusiveEvent Altamente recomendado Por quê? - Um PublicationEvent é usado para especificar a versão original (global ou local) do conteúdo de 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 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.
description Texto Altamente recomendado Por quê? Uma sinopse do episódio. As sinopses da trama são preferidas aos resumos factuais. Limite de 300 caracteres.
genre Texto Uma lista ordenada de todos os gêneros relevantes. Por exemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Texto Palavras-chave ou tags usadas para descrever esse conteúdo. Uma matriz de palavras-chave também é permitida. Por exemplo, ["feature, biography"] pode ser uma matriz de palavras-chave para descrever o conteúdo.
actor Person ou PerformingGroup ou PerformanceRole Altamente recomendado Por quê? Uma matriz dos membros do elenco do episódio. Confira as orientações de modelagem aqui.
director Person Altamente recomendado Por quê? Os diretores do episódio.
producer Organization ou Person Altamente recomendado Por quê? Os produtores da temporada.
image ImageObject Altamente recomendado Por quê? para o Google TV: várias imagens relacionadas ao TVEpisode. Para mais detalhes sobre as propriedades obrigatórias e opcionais a serem incluídas com image, consulte Propriedades de imagem.
trailer.description Texto A descrição do trailer. Confira o exemplo de trailer.
trailer.inLanguage Texto O idioma do trailer no formato BCP 47.
trailer.url URL Um URL de um trailer hospedado publicamente e enviado por estúdios de produção ou fontes autorizadas.
trailer.regionsAllowed Place As regiões em que a mídia é permitida. Se não for especificado, será considerado que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166.
review Review (em inglês) Revisar as classificações do episódio de TV
review.reviewRating Classificação Obrigatório se review for fornecido. É usado para especificar a nota dada na avaliação.
contentRating Texto ou Classificação Obrigatório para conteúdo adulto, altamente recomendado para outros tipos de conteúdo: classificação geral do conteúdo. Se a classificação do conteúdo for fornecida na forma de uma string de texto, duas variações serão aceitas:
  • A agência de classificação foi adicionada à classificação com um espaço em branco no meio. Por exemplo, uma classificação "TV-MA" da agência "TVPG" nos EUA precisa ser descrita como "TVPG TV-MA". Consulte a lista de agências.
  • Um valor de "RATING NOT KNOWN" (maiúsculas e minúsculas não são diferenciadas) para indicar que você não sabe a classificação do conteúdo.
contentRating.author Organização Obrigatório se contentRating usar Rating: o nome da agência de classificação. Consulte a página Agências de classificação de conteúdo para ver uma lista das agências de classificação aceitas.
contentRating.ratingValue Texto Obrigatório se contentRating usar Rating: o valor da classificação.
contentRating.advisoryCode Texto O código de aviso do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = diálogo, FV = violência de fantasia, L = linguagem, S = conteúdo sexual, V = violência.
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.
popularityScore PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia será reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos no seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
popularityScore.@type Texto Sempre defina como PopularityScoreSpecification.
popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. Quanto maior a pontuação, maior a popularidade.
popularityScore.eligibleRegion País Regiões em que esse índice de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
Note: A popularidade específica da localidade tem precedência sobre a global (EARTH)

TVSeason

Propriedade Tipo esperado Descrição
@context Texto Obrigatório: sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Em que"xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter o @language definido como o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que a legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre definido como TVSeason.
@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
  • 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.
url URL Obrigatório: o URL canônico do conteúdo, que o Google usa para fazer a correspondência entre o conteúdo do seu feed e o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • O url precisa conter um URL canônico que funcione e que o Google possa rastrear.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto alvo.
name Texto Obrigatório: o nome da temporada de TV.
  • Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo de representação de vários idiomas.
  • Apenas um nome é aceito por localidade (par de idioma e país).
titleEIDR Texto Altamente recomendado Por quê? - Um identificador EIDR (registro de identificador de entretenimento) que represente, no nível mais geral/abstrato, uma obra de cinema ou televisão.

Por exemplo, o titleEIDR da primeira temporada da série de TV "Game of Thrones" é "10.5240/FD91-C72C-4161-FCBA-058B-1".
seasonNumber Número inteiro Obrigatório: o número que indica a posição da temporada na ordem das temporadas da série de TV.
partOfSeries TVSeries Obrigatório: a série de TV a que a temporada pertence.
partOfSeries.@type Texto Obrigatório: sempre definido como TVSeries.
partOfSeries.@id URL Obrigatório: o @id do TVSeries a que a temporada pertence.
partOfSeries.name Texto Obrigatório: o nome da série de TV.
partOfSeries.sameAs Texto Um URL de uma página da Web de referência que pode identificar o programa, por exemplo, a página da Wikipédia do programa. Ele precisa ser diferente da propriedade url.
potentialAction WatchAction Obrigatório, se aplicável: um objeto de marcação de ação que fornece os detalhes da ação.
  • Se o conteúdo estiver disponível em vídeo on demand (VOD), essa propriedade será obrigatória. O objeto de marcação de ação precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal de TV ao vivo, essa propriedade será opcional. A entidade BroadcastService associada vai fornecer o link direto do canal.
  • Um TVSeason pode estar disponível no VoD e na TV ao vivo.
Use uma matriz para especificar links diretos diferentes em várias regiões. Consulte o exemplo de várias regiões e idiomas.
sameAs URL Altamente recomendado Por quê? Um URL de uma página da Web de referência que pode identificar a temporada, por exemplo, a página da Wikipédia da temporada. Ele precisa ser diferente da propriedade url.
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 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 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.
description Texto Altamente recomendado Por quê? Uma sinopse da temporada. As sinopses da trama são preferidas aos resumos factuais. Limite de 300 caracteres.
actor [Pessoa ou PerformingGroup ou PerformanceRole Altamente recomendado Por quê? Uma matriz com os membros do elenco da temporada. Confira as orientações de modelagem aqui.
director Person Altamente recomendado Por quê? Uma matriz com os diretores do programa.
producer Organization ou Person Altamente recomendado Por quê? Os produtores da temporada.
image ImageObject As imagens relacionadas à temporada de TV. Para mais detalhes sobre as propriedades obrigatórias e opcionais a serem incluídas com image, consulte Propriedades de imagem.
genre Texto Uma lista ordenada de todos os gêneros relevantes. Por exemplo : ["Action", "Fashion", "Environment", "Football"]
keywords Texto Palavras-chave ou tags usadas para descrever esse conteúdo. Uma matriz de palavras-chave também é permitida. Por exemplo, ["feature, biography"] pode ser uma matriz de palavras-chave para descrever o conteúdo.
trailer.description Texto A descrição do trailer. Confira o exemplo de trailer.
trailer.inLanguage Texto O idioma do trailer no formato BCP 47.
trailer.url URL Um URL de um trailer hospedado publicamente e enviado por estúdios de produção ou fontes autorizadas.
trailer.regionsAllowed Place As regiões em que a mídia é permitida. Se não for especificado, será considerado que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166.
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.
popularityScore PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia será reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos no seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
popularityScore.@type Texto Sempre defina como PopularityScoreSpecification.
popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. Quanto maior a pontuação, maior a popularidade.
popularityScore.eligibleRegion País Regiões em que esse índice de popularidade é aplicável. Se a pontuação de popularidade for aplicável globalmente, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
Note: A popularidade específica da localidade tem precedência sobre a global (EARTH)
review Review (em inglês) Analisar as classificações da temporada de TV
review.reviewRating Classificação Obrigatório se review for fornecido. É usado para especificar a nota dada na avaliação.
contentRating Texto ou Classificação Obrigatório para conteúdo adulto, altamente recomendado para outros tipos de conteúdo: classificação geral do conteúdo. Se a classificação do conteúdo for fornecida na forma de uma string de texto, duas variações serão aceitas:
  • A agência de classificação foi adicionada à classificação com um espaço em branco no meio. Por exemplo, uma classificação "TV-MA" da agência "TVPG" nos EUA precisa ser descrita como "TVPG TV-MA". Consulte a lista de agências.
  • Um valor de "RATING NOT KNOWN" (maiúsculas e minúsculas não são diferenciadas) para indicar que você não sabe a classificação do conteúdo.
contentRating.author Organização Obrigatório se contentRating usar Rating: o nome da agência de classificação. Consulte a página Agências de classificação de conteúdo para ver uma lista das agências de classificação aceitas.
contentRating.ratingValue Texto Obrigatório se contentRating usar Rating: o valor da classificação.
contentRating.advisoryCode Texto O código de aviso do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = diálogo, FV = violência de fantasia, L = linguagem, S = conteúdo sexual, V = violência.

Especificações do ator

A propriedade actor nos tipos de entidade TVSeries, TVEpisode e TVSeason permite especificar mais detalhes sobre os atores, incluindo o nome dos personagens e os papéis que eles interpretam no programa de TV. As seções a seguir fazem o mesmo, além de alguns exemplos que esclarecem o uso.

Propriedade Tipo esperado Descrição
actor Person ou PerformingGroup ou PerformanceRole Altamente recomendado Por quê? : Uma matriz dos membros do elenco.
  • Use o tipo PerformanceRole quando o papel e (opcionalmente) o nome do personagem do membro do elenco forem conhecidos. Neste caso, o ator Person ou PerformingGroup está incorporado ao objeto PerformanceRole.
  • Use o tipo Pessoa para indicar os atores individuais ou PerformingGroup para fornecer detalhes sobre o grupo/banda quando os papéis interpretados pelos membros do elenco forem desconhecidos.

Use uma matriz para representar várias pessoas, grupos de artistas ou funções de performance.

Como usar os tipos Person ou PerformingGroup

Forneça as propriedades a seguir quando o tipo Person ou PerformingGroup for usado

Propriedade Tipo esperado Descrição
@type Person ou PerformingGroup Obrigatório: sempre definido como Pessoa ou Grupo de apresentação.
@id URL Altamente recomendado Por quê? - O identificador de atores ou grupo de atores em formato de URI, por exemplo, https://example.com/actor/abc. @id precisa atender aos seguintes requisitos:
  • Globalmente exclusivo no seu catálogo por ator/grupo de artistas
  • O ID precisa ser estável e não pode ser alterado ao longo do tempo. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • No formato de identificador de recurso unificado (URI)
  • Sua organização precisa ser proprietária do domínio usado para o valor @id.

O @id usado na propriedade "ator" precisa ser usado de forma consistente em todo o feed. Por exemplo, se houver dois filmes com o mesmo ator, o valor @id precisará ser mantido igual nesses dois objetos de ator.

name Texto Obrigatório: o nome do ator/atriz/membro do elenco/grupo de performance.
sameAs URL Altamente recomendado Por quê? - Um URL de uma página da Web de referência que possa identificar o ator ou o grupo de artistas, por exemplo, a página do ator na Wikipédia. Ele precisa ser diferente da propriedade @id.

Como usar o tipo PerformanceRole

Forneça as propriedades a seguir quando o tipo PerformanceRole for usado

Propriedade Tipo esperado Descrição
@type PerformanceRole Obrigatório: sempre definido como PerformanceRole.
roleName Texto Altamente recomendado Por quê? - Um papel interpretado, realizado ou preenchido pelo membro do elenco. Confira a lista de valores aceitáveis aqui.
characterName Texto O nome de um personagem interpretado em algum papel de atuação ou performance. Não defina esse campo se o tipo de ator for PerformingGroup.
actor Person ou PerformingGroup Obrigatório -
  • Os membros do elenco do conteúdo quando o tipo de dados Pessoa é usado.
  • Os grupos/bandas que tocam o conteúdo quando o tipo de dados PerformingGroup é usado.
actor.@type Person ou PerformingGroup Obrigatório: sempre definido como Pessoa ou Grupo de apresentação.
actor.@id URL Altamente recomendado Por quê? - O identificador do usuário ou do grupo de execução no formato de URI. Por exemplo, https://example.com/actor/abc. O @id precisa atender aos seguintes requisitos:
  • Globalmente exclusivo no seu catálogo por ator/grupo de artistas
  • O ID precisa ser estável e não pode ser alterado ao longo do tempo. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • No formato de identificador de recurso unificado (URI)
  • Sua organização precisa ser proprietária do domínio usado para o valor @id.

O @id usado na propriedade "ator" precisa ser usado de forma consistente em todo o feed. Por exemplo, se houver dois filmes com o mesmo ator, o valor @id precisará ser mantido igual nesses dois objetos de ator.

actor.name Texto Obrigatório: o nome do ator/atriz/membro do elenco/grupo de performance.
actor.sameAs URL Altamente recomendado Por quê? - Um URL de uma página da Web de referência que possa identificar o ator ou o grupo de artistas, por exemplo, a página da Wikipédia do ator. Ela precisa ser diferente da propriedade actor.@id.

Nomes de função aceitáveis

Esses valores exigem que actor.@type seja Person.

Valor de roleName Descrição
"Cameo" Um papel de participação especial, também chamado de participação especial, é uma breve aparição de uma pessoa conhecida em uma obra de artes cênicas.
"VoiceActor" Uma performance de voz é aquela em que a voz do ator é usada, mas o ator não aparece na tela. Isso é mais comum em animações, mas também ocorre quando a voz de um ator é dublada sobre a fala de outro ator.
"Duplo" Um dublê é uma pessoa que substitui outro ator de modo que o rosto dele não seja mostrado.
"MotionCaptureActor" Um MotionCaptureActor se refere a uma pessoa que grava ações de atores humanos e usa essas informações para animar modelos de personagens digitais em animações 2D ou 3D.

Esses valores geralmente são aceitos para os tipos Person e PerformingGroup.

Valor de roleName Descrição
"Ator" Um ator ou atriz é uma pessoa que interpreta um personagem em uma performance no meio tradicional do teatro ou em mídias modernas, como filmes, rádio e televisão.
"GuestStar" "Um ator convidado é um ator que interpreta um papel fictício e aparece em um ou alguns episódios. Em alguns casos, um ator convidado pode interpretar um personagem recorrente importante e aparecer muitas vezes em uma série, mesmo não sendo um membro do elenco principal. Defina o valor como "GuestStar" quando o elenco tiver uma performance de convidado ou for um convidado no programa. Os atores convidados devem ser fornecidos apenas no nível do episódio e não devem ser adicionados no nível da série de TV.
"Convidado" "Um convidado em um programa de entrevistas. Enquanto "GuestStar" é um papel fictício, "Guest" é uma aparição não fictícia.
"Apresentador" Um locutor é uma pessoa que faz discursos de abertura e encerramento do programa, apresenta o apresentador, os competidores e/ou convidados famosos, descreve os prêmios disponíveis, aquece o público antes da gravação e o mantém entretido durante os intervalos.
"Comentarista" Um comentarista faz comentários em tempo real sobre um jogo ou evento, geralmente durante uma transmissão ao vivo.
"Impressionista" Um imitador é um artista que imita sons, vozes e maneirismos de celebridades e personagens de desenhos animados.
"Host" Uma pessoa que apresenta, apresenta ou apresenta programas de televisão, muitas vezes atuando como mediadora entre o programa e o público. O "Apresentador" geralmente é um papel de não ficção.
"CoHost" Uma pessoa que organiza um evento/programa com outras pessoas.
"GuestHost" Um apresentador convidado é um apresentador, geralmente de um talk show, que apresenta o programa no lugar do apresentador regular quando ele não está disponível.
"Apresentador de notícias" Uma pessoa que apresenta/informa o público sobre notícias e eventos que acontecem em nível local, nacional e internacional em um programa de notícias de TV.
"Correspondente" Um correspondente ou repórter de plantão geralmente é um jornalista ou comentarista de uma revista, ou um agente que contribui com reportagens para um jornal, noticiário de rádio ou televisão ou outro tipo de empresa, de um local remoto, muitas vezes distante.
"ShowJudge" Um juiz é uma pessoa que geralmente é considerada especialista na área do programa e recebe o papel de "juiz" para criticar os competidores que fazem testes e entram na competição da série de TV.
"Panelist" Membro de um painel de discussão ou consultivo de um programa de rádio ou televisão.
"Concorrente" Um participante de uma competição ou programa de jogos é uma pessoa que participa dele.
"StoryNarrator" Narrador é uma pessoa que narra algo, especialmente um personagem que reconta os eventos de um romance ou poema narrativo
"MusicalArtist" "Um artista musical pode ser uma pessoa ou um grupo ou um personagem fictício que normalmente se apresenta para um público regularmente ou gravou faixas ou álbuns musicais. Compositores e letristas só devem ter esse tipo se os créditos de alguma obra musical indicarem que eles também contribuíram como intérpretes principais. Esse tipo pode ser usado para associar músicos ou grupos de músicos permanentes e músicos ou grupos de músicos convidados a shows.

Diferenciar entre um papel principal e um coadjuvante de um ator

Para diferenciar os atores principais/regulares e convidados/de apoio em um programa de TV, adicione o elenco principal apenas nas entidades TVSeries e adicione apenas o elenco convidado ou o elenco com papéis de apoio nas entidades TVEpisode. Verifique se o elenco principal/regular não foi adicionado às entidades TVEpisode.

Exemplos

Exemplo de TVSeries, TVEpisode e TVSeason

TVSeries 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Exemplos de propriedades Actor

O papel do ator é desconhecido

Quando o papel de um ator é desconhecido, nossa recomendação é fornecer apenas as informações do ator usando o Person ou PerformingGroup tipo

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

O papel do ator é conhecido

Quando o papel de um ator é conhecido, recomendamos fornecer as informações do ator usando o tipo PerformanceRole.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

Funções conhecidas para um subconjunto de atores

Quando os metadados de função de performance não são conhecidos, nossa recomendação é fornecer as informações do ator usando o Pessoa ou Grupo de performance tipo. No outro caso em que essas informações são conhecidas, use o PerformanceRole . Esses tipos podem ser adicionados juntos na mesma matriz.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

Confira as páginas a seguir para ver os tópicos relacionados a essas propriedades: