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

Esta seção fornece detalhes sobre as 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 entre TVSeries, TVSeason e TVEpisode para mais detalhes.

Tabela de especificação

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 da legenda/dublagem seja inglês.
@type Texto Obrigatório: sempre definido como TVSeries.
@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
  • O ID precisa ser estável e não pode mudar com o tempo, mesmo que a propriedade "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 corresponder o conteúdo do seu feed com o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico funcional que o Google possa rastrear.
Para o link direto de reprodução, consulte a propriedade urlTemplate do objeto target.
name Texto Obrigatório: o nome do programa.
  • 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).
titleEIDR Texto Altamente recomendável Por quê? - Um identificador EIDR (Entertainment Identifier Registry) que representa, no nível mais geral/abstrato, uma obra de cinema ou televisão.

Por exemplo, o EIDR do título 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 da LiveTV, essa propriedade será opcional. A entidade BroadcastService associada fornece 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 Várias regiões e idiomas.
sameAs URL Altamente recomendável Por quê? É o URL de uma página da Web de referência que pode identificar o programa, por exemplo, a página da Wikipédia. Ele precisa ser diferente da propriedade url.
inLanguage Texto Altamente recomendado: 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 o conteúdo. Também é permitido usar um array de palavras-chave. Por exemplo, ["feature, biography"] pode ser uma matriz de palavras-chave para descrever o conteúdo.
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 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 indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado pela primeira vez nos cinemas.

Para ExclusiveEvent e FeaturedEvent, 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, representa a data em que os direitos sobre o conteúdo expiram.

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

Se o conteúdo for perpetuamente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organization ou Person Opcional: a organização ou pessoa que publicou essa entidade.
description Texto Altamente recomendável Por quê? Uma sinopse do programa. Sinopses são preferíveis a resumos factuais. Limite de 300 caracteres.
actor Person ou PerformingGroup ou PerformanceRole Altamente recomendável Por quê? Uma matriz dos membros do elenco da série. Confira as orientações de modelagem aqui.
director Person Altamente recomendável Por quê? São os diretores do programa.
producer Organization ou Person Altamente recomendável 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 Altamente recomendado: o idioma do trailer no formato BCP 47.
trailer.url URL Um URL de um trailer hospedado publicamente e enviado pelos respectivos estúdios de produção ou fontes autorizadas.
trailer.regionsAllowed Place São as regiões onde a mídia é permitida. Se não for especificado, vamos presumir que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166.
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.
popularityScore PopularityScoreSpecification Altamente recomendável Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia reproduzir para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros itens do seu catálogo. Portanto, a escala da pontuação precisa ser consistente em todos os seus feeds e entre todas as entidades do 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 essa pontuação 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 (TERRA)
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 classificação dada na avaliação.
contentRating Texto ou Classificação Obrigatório para conteúdo adulto, altamente recomendado para outros casos: 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 precedida pela classificação com um espaço em branco entre elas. Por exemplo, uma classificação "TV-MA" da agência "TVPG" nos EUA precisa ser descrita como "TVPG TV-MA". Confira a lista de agências.
  • Um valor de "CLASSIFICAÇÃO DESCONHECIDA" (sem diferenciação de maiúsculas e minúsculas) 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 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 o idioma da legenda/dublagem seja inglês.
@type Texto Obrigatório: sempre definido como TVEpisode.
@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
  • O ID precisa ser estável e não pode mudar com o tempo, mesmo que a propriedade "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 corresponder o conteúdo do seu feed com o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico funcional que o Google possa rastrear.
Para o link direto de reprodução, consulte a propriedade urlTemplate do objeto target.
name Texto Obrigatório: o nome do episódio.
  • Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo Representação em vários idiomas.
  • Só é possível usar um nome por localidade (par idioma-país).
titleEIDR Texto Altamente recomendável Por quê? - Um identificador EIDR (Entertainment Identifier Registry) que representa, no nível mais geral/abstrato, uma obra de cinema ou televisão.

Por exemplo, o EIDR do título 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 recomendável Por quê? - Um identificador EIDR (Registro Identificador de Entretenimento) que representa uma edição específica de uma obra cinematográfica ou televisiva.

Por exemplo, o primeiro episódio da primeira temporada da série de TV "Game of Thrones", cujo EIDR de título é "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 "editEIDR" é fornecido.
inLanguage Texto Altamente recomendado: idioma original do episódio no formato BCP 47.
episodeNumber Número inteiro Obrigatório: o número que indica a posição deste episódio na ordem de episódios de uma temporada. 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 este 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 este episódio pertence.
partOfSeason.seasonNumber Número inteiro Obrigatório: o número que indica a posição desta 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 este episódio pertence.
partOfSeries.name Texto Obrigatório: o nome da série de TV.
partOfSeries.sameAs Texto É o URL de uma página da Web de referência que pode identificar o programa, por exemplo, a página da Wikipédia. 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 da LiveTV, essa propriedade será opcional. A entidade BroadcastService associada fornece 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 Várias regiões e idiomas.
sameAs Altamente recomendável Por quê? URL Um URL para uma página da Web de referência que pode identificar o episódio, por exemplo, a página da Wikipédia do episódio. Ele precisa ser diferente da propriedade url.
duration Duração Tempo de execução do episódio no formato ISO 8601. Use o formato "PT00H00M".
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 exclusivos de distribuição 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 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 indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado pela primeira vez nos cinemas.

Para ExclusiveEvent e FeaturedEvent, 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, representa a data em que os direitos sobre o conteúdo expiram.

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

Se o conteúdo for perpetuamente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organization ou Person Opcional: a organização ou pessoa que publicou essa entidade.
description Texto Altamente recomendável Por quê? Uma sinopse do episódio. Sinopses de enredo são preferíveis a 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 o conteúdo. Também é permitido usar um array de palavras-chave. Por exemplo, ["feature, biography"] pode ser uma matriz de palavras-chave para descrever o conteúdo.
actor Person ou PerformingGroup ou PerformanceRole Altamente recomendável Por quê? Uma matriz dos membros do elenco do episódio. Confira as orientações de modelagem aqui.
director Person Altamente recomendável Por quê? São os diretores do episódio.
producer Organization ou Person Altamente recomendável 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 Altamente recomendado: o idioma do trailer no formato BCP 47.
trailer.url URL Um URL de um trailer hospedado publicamente e enviado pelos respectivos estúdios de produção ou fontes autorizadas.
trailer.regionsAllowed Place São as regiões onde a mídia é permitida. Se não for especificado, vamos presumir que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166.
review Review (em inglês) Analisar as classificações do episódio de TV
review.reviewRating Classificação Obrigatório se review for fornecido. Usado para especificar a classificação dada na avaliação.
contentRating Texto ou Classificação Obrigatório para conteúdo adulto, altamente recomendado para outros casos: 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 precedida pela classificação com um espaço em branco entre elas. Por exemplo, uma classificação "TV-MA" da agência "TVPG" nos EUA precisa ser descrita como "TVPG TV-MA". Confira a lista de agências.
  • Um valor de "CLASSIFICAÇÃO DESCONHECIDA" (sem diferenciação de maiúsculas e minúsculas) 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 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 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.
popularityScore PopularityScoreSpecification Altamente recomendável Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia reproduzir para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros itens do seu catálogo. Portanto, a escala da pontuação precisa ser consistente em todos os seus feeds e entre todas as entidades do 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 essa pontuação 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 (TERRA)

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 o idioma da legenda/dublagem seja inglês.
@type Texto Obrigatório: sempre definido como TVSeason.
@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
  • O ID precisa ser estável e não pode mudar com o tempo, mesmo que a propriedade "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 corresponder o conteúdo do seu feed com o conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico funcional que o Google possa rastrear.
Para o link direto de reprodução, consulte a propriedade urlTemplate do objeto target.
name Texto Obrigatório: o nome desta temporada de TV.
  • Use uma matriz para listar os nomes em diferentes idiomas. Consulte o exemplo Representação em vários idiomas.
  • Só é possível usar um nome por localidade (par idioma-país).
titleEIDR Texto Altamente recomendável Por quê? - Um identificador EIDR (Entertainment Identifier Registry) que representa, no nível mais geral/abstrato, uma obra de cinema ou televisão.

Por exemplo, o EIDR do título 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 desta temporada na ordem das temporadas da série de TV.
partOfSeries TVSeries Obrigatório: a série de TV a que esta temporada pertence.
partOfSeries.@type Texto Obrigatório: sempre definido como TVSeries.
partOfSeries.@id URL Obrigatório: o @id do TVSeries a que esta temporada pertence.
partOfSeries.name Texto Obrigatório: o nome da série de TV.
partOfSeries.sameAs Texto É o URL de uma página da Web de referência que pode identificar o programa, por exemplo, a página da Wikipédia. 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 da LiveTV, essa propriedade será opcional. A entidade BroadcastService associada fornece o link direto do canal.
  • Um TVSeason 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 Várias regiões e idiomas.
sameAs URL Altamente recomendável Por quê? É o 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 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 exclusivos de distribuição 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 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 indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado pela primeira vez nos cinemas.

Para ExclusiveEvent e FeaturedEvent, 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, representa a data em que os direitos sobre o conteúdo expiram.

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

Se o conteúdo for perpetuamente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organization ou Person Opcional: a organização ou pessoa que publicou essa entidade.
description Texto Altamente recomendável Por quê? Uma sinopse da temporada. Sinopses de enredo são preferíveis a resumos factuais. Limite de 300 caracteres.
actor [Person ou PerformingGroup ou PerformanceRole Altamente recomendável Por quê? Uma matriz dos membros do elenco da temporada. Confira as orientações de modelagem aqui.
director Person Altamente recomendável Por quê? Uma matriz dos diretores da série.
producer Organization ou Person Altamente recomendável Por quê? Os produtores da temporada.
image ImageObject As imagens relacionadas à TVSeason. 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 o conteúdo. Também é permitido usar um array de palavras-chave. Por exemplo, ["recurso, biografia"] 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 Altamente recomendado: o idioma do trailer no formato BCP 47.
trailer.url URL Um URL de um trailer hospedado publicamente e enviado pelos respectivos estúdios de produção ou fontes autorizadas.
trailer.regionsAllowed Place São as regiões onde a mídia é permitida. Se não for especificado, vamos presumir que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166.
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.
popularityScore PopularityScoreSpecification Altamente recomendável Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia reproduzir para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros itens do seu catálogo. Portanto, a escala da pontuação precisa ser consistente em todos os seus feeds e entre todas as entidades do 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 essa pontuação 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 (TERRA)
review Review (em inglês) Revisar as classificações da temporada de TV
review.reviewRating Classificação Obrigatório se review for fornecido. Usado para especificar a classificação dada na avaliação.
contentRating Texto ou Classificação Obrigatório para conteúdo adulto, altamente recomendado para outros casos: 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 precedida pela classificação com um espaço em branco entre elas. Por exemplo, uma classificação "TV-MA" da agência "TVPG" nos EUA precisa ser descrita como "TVPG TV-MA". Confira a lista de agências.
  • Um valor de "CLASSIFICAÇÃO DESCONHECIDA" (sem diferenciação de maiúsculas e minúsculas) 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 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 desempenham no programa de TV. As seções a seguir capturam o mesmo, além de alguns exemplos que esclarecem o uso.

Propriedade Tipo esperado Descrição
actor Person ou PerformingGroup ou PerformanceRole Altamente recomendável Por quê? : Uma matriz dos membros do elenco.
  • Use o tipo PerformanceRole quando o papel desempenhado e (opcionalmente) o nome do personagem dos membros do elenco forem conhecidos. O ator Person ou PerformingGroup está incorporado ao objeto PerformanceRole nesse caso.
  • Use o tipo Person para indicar os atores individuais ou PerformingGroup para fornecer detalhes sobre os grupos/bandas quando as funções desempenhadas pelos membros do elenco são desconhecidas.

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

Como usar os tipos Person ou PerformingGroup

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

Propriedade Tipo esperado Descrição
@type Person ou PerformingGroup Obrigatório: sempre definido como Person ou PerformingGroup
@id URL Altamente recomendável Por quê? - O identificador dos atores ou do grupo de apresentação em formato URI, por exemplo, https://example.com/actor/abc. @id precisa atender aos seguintes requisitos:
  • Globalmente exclusivo em todo o catálogo por ator/grupo de performance
  • 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 o mesmo nos dois objetos de ator.

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

Como usar o tipo PerformanceRole

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

Propriedade Tipo esperado Descrição
@type PerformanceRole Obrigatório: sempre definido como PerformanceRole
roleName Texto Altamente recomendável Por quê? - Uma função desempenhada, realizada ou preenchida pelo membro do elenco. Confira a lista de valores aceitos aqui.
characterName Texto O nome de um personagem interpretado em alguma função 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 Person é usado.
  • O(s) grupo(s)/banda(s) que executam o conteúdo quando o tipo de dados PerformingGroup é usado.
actor.@type Person ou PerformingGroup Obrigatório: sempre definido como Person ou PerformingGroup
actor.@id URL Altamente recomendável Por quê? - O identificador do ator ou do grupo de performance no formato URI. Por exemplo, https://example.com/actor/abc. @id precisa atender aos seguintes requisitos:
  • Globalmente exclusivo em todo o catálogo por ator/grupo de performance
  • 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 o mesmo nos dois objetos de ator.

actor.name Texto Obrigatório: o nome do ator/atriz/membro do elenco/grupo de apresentação.
actor.sameAs URL Altamente recomendável Por quê? - Um URL para uma página da Web de referência que pode 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

Para esses valores, é necessário que actor.@type seja Person.

Valor de roleName Descrição
"Cameo" Uma 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 ele não aparece na tela. Isso é mais comum em animações, mas também acontece quando a voz de um ator é dublada sobre a fala de outro.
"Double" Um dublê é uma pessoa que substitui outro ator de modo que o rosto da pessoa 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ção de computador 2D ou 3D.

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

Valor de roleName Descrição
"Ator" Um ator ou atriz é uma pessoa que interpreta um personagem em uma apresentação no meio tradicional do teatro ou em mídias modernas, como cinema, rádio e televisão.
"GuestStar" "Uma participação especial é um ator que interpreta um papel fictício e aparece em um ou alguns episódios. Em alguns casos, uma participação especial pode interpretar um personagem recorrente importante e aparecer muitas vezes em uma série, mesmo sem fazer parte do elenco principal. Defina o valor como "GuestStar" quando o elenco tiver uma participação especial ou for um convidado no programa. As participações especiais devem ser fornecidas apenas no nível do episódio e não podem ser adicionadas no nível da série de TV.
"Visitante" "Um convidado em um talk show. Embora "GuestStar" seja uma função fictícia, "Guest" é uma aparição não fictícia.
"Anunciante" Um locutor é uma pessoa que faz a abertura e o encerramento do programa, apresenta o apresentador, os participantes e/ou os convidados famosos, descreve os prêmios disponíveis e anima a plateia antes da gravação e durante os intervalos.
"Comentarista" Um comentarista faz comentários em tempo real sobre um jogo ou evento, geralmente durante uma transmissão ao vivo.
"Impressionist" Um imitador é um artista que imita sons, vozes e trejeitos de celebridades e personagens de desenhos animados.
"Host" Uma pessoa que apresenta ou comanda programas de televisão, geralmente servindo como mediadora entre o programa e o público. O "Host" geralmente é um papel de não ficção.
"CoHost" Uma pessoa que organiza um evento/programa com outra(s).
"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.
"Newscaster" Uma pessoa que apresenta/informa o público sobre notícias e eventos locais, nacionais e internacionais em um programa de notícias da TV.
"Correspondente" Um correspondente ou repórter no local geralmente é um jornalista ou comentarista de uma revista, um agente que contribui com reportagens para um jornal, 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 a função de "juiz" para criticar os participantes que fazem testes e entram na competição da série de TV.
"Participante" Um membro de um painel de discussão ou consultivo de um programa de rádio ou televisão.
"Participante" Um participante de uma competição ou programa de jogos é uma pessoa que participa dela.
"StoryNarrator" Narrador é uma pessoa que narra algo, especialmente um personagem que conta os eventos de um romance ou poema narrativo.
"MusicalArtist" "Um artista musical pode ser uma pessoa, um grupo ou um personagem fictício que geralmente se apresenta para um público regularmente ou gravou músicas ou álbuns musicais. Compositores e letristas só podem ter esse tipo se os créditos de alguma obra musical implicarem que eles também contribuem como intérprete principal. Esse tipo pode ser usado para associar músicos ou grupos musicais permanentes e músicos ou grupos musicais convidados a shows.

Diferenciar entre um papel principal e um papel de apoio de um ator

Para diferenciar os atores principais/regulares e os convidados/de apoio em um programa de TV, adicione o elenco principal apenas nas entidades TVSeries e o elenco convidado ou 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

A função do ator é desconhecida

Quando a função de um ator é desconhecida, recomendamos fornecer apenas as informações do ator usando o tipo Person ou PerformingGroup.

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

A função do ator é conhecida

Quando a função de um ator é conhecida, recomendamos fornecer as informações dele 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 da função de performance não são conhecidos, recomendamos fornecer as informações do ator usando o tipo Person ou PerformingGroup. Para o outro caso em que essas informações são conhecidas, use o tipo PerformanceRole . Esses tipos podem ser adicionados 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 seguintes páginas para ver os tópicos relacionados a essas propriedades: