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 ver detalhes.

Tabela de especificações

TVSeries

Propriedade Tipo esperado Descrição
@context Texto Obrigatório - sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Onde"xx" representa o idioma das strings no feed. Cada contexto de entidade raiz deve ter @language definido para o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver configurado para espanhol, presume-se que os nomes estejam em espanhol, mesmo que o idioma da legenda seja o mesmo.
@type Texto Obrigatório: defina sempre 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 seu catálogo
  • O código precisa ser estável e não pode ser alterado ao longo do tempo, mesmo que a propriedade do URL do programa seja alterada. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • na forma de um Identificador de Recursos unificados (URI)
  • O domínio usado para o valor @id deve pertencer à sua organização.
Como o url de uma entidade atende a todos os requisitos como um 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, usado pelo Google para fazer a correspondência entre o conteúdo no seu feed e o banco de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico que o Google possa rastrear.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
name Texto Obrigatório: é o nome do programa.
  • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo em 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 (Entretenimento Identifier Registry), representando no nível mais geral/abstrato, uma obra de filme ou televisão.

Por exemplo, o título EIDR para a série de TV conhecida como "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 no Video on Demand (VoD), essa propriedade será obrigatória. O objeto de marcação Ação precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal LiveTV, esta propriedade é opcional. A entidade BroadcastService associada fornece o link direto do canal.
  • Um TVSeries pode estar disponível em VoD e LiveTV.
Use uma matriz para especificar links diretos diferentes em várias regiões. Veja o exemplo em Várias regiões e idiomas.
sameAs URL Altamente recomendado Por quê? Um URL para uma página da Web de referência que pode identificar o programa (por exemplo, a página da Wikipédia sobre ele). 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, ["recurso, biografia"] 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 o lançamento original (global ou local) de conteúdo de um editor, como a data de lançamento cinematográfico 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 exemplo 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 este evento.

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

Para FeaturedEvent e ExclusiveEvent, essa é a região em que o conteúdo é destacado ou exclusivo.

Use códigos ISO 3166 para países. Para indicar em qualquer lugar do mundo, defina como EARTH.
releasedEvent.startDate Date ou DateTime Recomendado - obrigatório para ExclusiveEvent - a data de início da publicação da entidade.

Para um PublicationEvent, isso indica a data de lançamento inicial desta entidade, como a data em que um filme foi lançado nos cinemas pela primeira vez.

Para ExclusiveEvent e FeaturedEvent, representa a data de início de quando a entidade é exclusiva ou está 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 em que os direitos do conteúdo expiram.

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

Se o conteúdo for perpétuamente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organization ou Person Opcional: é a organização ou a pessoa que publicou a entidade.
description Texto Altamente recomendado Por quê? Uma sinopse do programa. Sinopses do enredo são preferenciais aos resumos factuais. Limite de 300 caracteres.
actor Person, PerformingGroup ou PerformanceRole Altamente recomendado Por quê? Uma matriz dos membros do elenco da série. Veja aqui as orientações para modelagem.
director Person Altamente recomendado Por quê? Os diretores do programa.
producer Organization ou Person Altamente recomendado Por quê? São os produtores do programa.
image ImageObject Obrigatório para o Google TV: as imagens relacionadas ao TVSeries. 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. Veja o exemplo do trailer.
trailer.inLanguage Texto O idioma do trailer no formato BCP 47.
trailer.url URL O URL de um trailer hospedado publicamente e enviado por seus respectivos 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, ele será considerado permitido em todos os lugares. Especifique os países no formato ISO 3166.
identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro ID que identifica claramente essa entidade. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.
popularityScore Pontuação de popularidade Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros sinais, para determinar qual mídia deve 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 entre os feeds, entre todas as entidades do seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
popularityScore.@type Texto Sempre definido como PopularityScoreSpecification.
popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. Uma pontuação mais alta significa mais popularidade.
popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for globalmente aplicável, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
Note: A popularidade específica por localidade tem precedência sobre a popularidade global (EARTH)
review Review (em inglês) Avaliar classificações da série de TV
review.reviewRating Classificação Obrigatório se review for fornecido. Ele é usado para especificar a classificação dada na avaliação.
contentRating Texto ou Classificação Obrigatório para conteúdo adulto, altamente recomendado: é a classificação geral do conteúdo. Se a classificação do conteúdo for fornecida na forma de uma string de texto, serão aceitas duas variações:
  • A agência de classificação precedeu a avaliação com um espaço em branco entre eles. Por exemplo, uma classificação "TV-MA" da agência "TVPG" nos EUA deve ser descrita como "TVPG TV-MA". Veja a lista de agências.
  • Um valor de "RATING NOT KNOWN" (não diferencia maiúsculas de minúsculas) para indicar que você não sabe a classificação do conteúdo.
contentRating.author Texto ou 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 de 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 consultivo do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = diálogo, FV = violência de fantasia , L = idioma, 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"}]
  • Onde"xx" representa o idioma das strings no feed. Cada contexto de entidade raiz deve ter @language definido para o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver configurado para espanhol, presume-se que os nomes estejam em espanhol, mesmo que o idioma da legenda seja o mesmo.
@type Texto Obrigatório: defina sempre 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 seu catálogo
  • O código precisa ser estável e não pode ser alterado ao longo do tempo, mesmo que a propriedade do URL do programa seja alterada. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • na forma de um Identificador de Recursos unificados (URI)
  • O domínio usado para o valor @id deve pertencer à sua organização.
Como o url de uma entidade atende a todos os requisitos como um 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, usado pelo Google para fazer a correspondência entre o conteúdo no seu feed e o banco de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico que o Google possa rastrear.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
name Texto Obrigatório: é o nome do episódio.
  • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo 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 (Entretenimento Identifier Registry), representando no nível mais geral/abstrato, uma obra de filme ou televisão.

Por exemplo, o título EIDR para o primeiro episódio da primeira temporada de TVSeries, conhecido como "Game of Thrones", é "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
editEIDR Texto Altamente recomendado Por quê? - Um identificador EIDR (Entretenimento Identifier Registry), representando uma edição / edição específica para uma obra de filme ou televisão.

Por exemplo, o primeiro episódio da primeira temporada de TVSeries, conhecido como "Game of Thrones", tem 10.5240/B6A6-1B32-B5E5-D5CB-6B84-X como título, "10.5240/FB97-C847-2969-10EC".
A propriedade
titleEIDR é obrigatória quando o EIDR de edição é 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 em uma temporada. O episodeNumber precisa ser reiniciado para cada temporada, ou seja, o primeiro episódio de cada temporada precisa ser 1.
partOfSeason Temporada Obrigatório: é a temporada de TV a que este episódio pertence.

Mesmo que um TVEpisode não tenha um TVSeason correspondente, você ainda precisa fornecer as propriedades partOfSeason.@id e partOfSeason.seasonNumber. Uma solução alternativa é:
  • Use partofSeries.@id (por exemplo, http://www.example.com/my_favorite_tv_show) e anexe um campo de consulta de marcador (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: defina sempre como TVSeason.
partOfSeason.@id URL Obrigatório: o @id do TVSeason de que este episódio faz parte.
partOfSeason.seasonNumber Número inteiro Obrigatório: é o número que indica a posição da temporada na ordem das temporadas na série de TV.
partOfSeries Série de TV Obrigatório: é a série de TV a que este episódio pertence.
partOfSeries.@type Texto Obrigatório: defina sempre como TVSeries.
partOfSeries.@id URL Obrigatório: o @id do TVSeries de que este episódio faz parte.
partOfSeries.name Texto Obrigatório: o nome da série de TV.
partOfSeries.sameAs Texto Um URL para uma página da Web de referência que pode identificar o programa (por exemplo, a página da Wikipédia sobre ele). 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 no Video on Demand (VoD), essa propriedade será obrigatória. O objeto de marcação Ação precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal LiveTV, esta propriedade é opcional. A entidade BroadcastService associada fornece o link direto do canal.
  • Um TVEpisode pode estar disponível em VoD e LiveTV.
Use uma matriz para especificar links diretos diferentes em várias regiões. Veja o exemplo em Várias regiões e idiomas.
sameAs Altamente recomendado 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 recomendado Por quê? - Um PublicationEvent é usado para especificar o lançamento original (global ou local) de conteúdo de um editor, como a data de lançamento cinematográfico 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 exemplo 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 este evento.

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

Para FeaturedEvent e ExclusiveEvent, essa é a região em que o conteúdo é destacado ou exclusivo.

Use códigos ISO 3166 para países. Para indicar em qualquer lugar do mundo, defina como EARTH.
releasedEvent.startDate Date ou DateTime Recomendado - obrigatório para ExclusiveEvent - a data de início da publicação da entidade.

Para um PublicationEvent, isso indica a data de lançamento inicial desta entidade, como a data em que um filme foi lançado nos cinemas pela primeira vez.

Para ExclusiveEvent e FeaturedEvent, representa a data de início de quando a entidade é exclusiva ou está 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 em que os direitos do conteúdo expiram.

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

Se o conteúdo for perpétuamente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organization ou Person Opcional: é a organização ou a pessoa que publicou a entidade.
description Texto Altamente recomendado Por quê? Uma sinopse do episódio. Sinopses do enredo são preferenciais 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, ["recurso, biografia"] pode ser uma matriz de palavras-chave para descrever o conteúdo.
actor Person, PerformingGroup ou PerformanceRole Altamente recomendado Por quê? Uma matriz dos membros do elenco do episódio. Veja aqui as orientações para modelagem.
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 Recomendado por quê? para o Google TV: várias imagens relacionadas ao episódio 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. Veja o exemplo do trailer.
trailer.inLanguage Texto O idioma do trailer no formato BCP 47.
trailer.url URL O URL de um trailer hospedado publicamente e enviado por seus respectivos 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, ele será considerado permitido em todos os lugares. Especifique os países no formato ISO 3166.
review Review (em inglês) Avaliar classificações para o episódio de TV
review.reviewRating Classificação Obrigatório se review for fornecido. Ele é usado para especificar a classificação dada na avaliação.
contentRating Texto ou Classificação Obrigatório para conteúdo adulto, altamente recomendado: é a classificação geral do conteúdo. Se a classificação do conteúdo for fornecida na forma de uma string de texto, serão aceitas duas variações:
  • A agência de classificação precedeu a avaliação com um espaço em branco entre eles. Por exemplo, uma classificação "TV-MA" da agência "TVPG" nos EUA deve ser descrita como "TVPG TV-MA". Veja a lista de agências.
  • Um valor de "RATING NOT KNOWN" (não diferencia maiúsculas de minúsculas) para indicar que você não sabe a classificação do conteúdo.
contentRating.author Texto ou 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 de 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 consultivo do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = diálogo, FV = violência de fantasia , L = idioma, S = conteúdo sexual, V = violência.
identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro ID que identifica claramente essa entidade. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.
popularityScore Pontuação de popularidade Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros sinais, para determinar qual mídia deve 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 entre os feeds, entre todas as entidades do seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
popularityScore.@type Texto Sempre definido como PopularityScoreSpecification.
popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. Uma pontuação mais alta significa mais popularidade.
popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for globalmente aplicável, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
Note: A popularidade específica por localidade tem precedência sobre a popularidade global (EARTH)

TVSeason

Propriedade Tipo esperado Descrição
@context Texto Obrigatório - sempre definido como ["http://schema.org", {"@language": "xx"}]
  • Onde"xx" representa o idioma das strings no feed. Cada contexto de entidade raiz deve ter @language definido para o código de idioma apropriado no formato BCP 47. Por exemplo, se o idioma estiver configurado para espanhol, presume-se que os nomes estejam em espanhol, mesmo que o idioma da legenda seja o mesmo.
@type Texto Obrigatório: defina sempre 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 seu catálogo
  • O código precisa ser estável e não pode ser alterado ao longo do tempo, mesmo que a propriedade do URL do programa seja alterada. Ele será tratado como uma string opaca e não precisa ser um link funcional.
  • na forma de um Identificador de Recursos unificados (URI)
  • O domínio usado para o valor @id deve pertencer à sua organização.
Como o url de uma entidade atende a todos os requisitos como um 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, usado pelo Google para fazer a correspondência entre o conteúdo no seu feed e o banco de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico que o Google possa rastrear.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
name Texto Obrigatório: o nome desta temporada de TV.
  • Use uma matriz para listar os nomes em diferentes idiomas. Veja o exemplo 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 (Entretenimento Identifier Registry), representando no nível mais geral/abstrato, uma obra de filme ou televisão.

Por exemplo, o título EIDR para a primeira temporada de TVSeries, conhecido como "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 na série de TV.
partOfSeries Série de TV Obrigatório: é a série de TV a que a temporada pertence.
partOfSeries.@type Texto Obrigatório: defina sempre como TVSeries.
partOfSeries.@id URL Obrigatório: o @id do TVSeries de que esta temporada faz parte.
partOfSeries.name Texto Obrigatório: o nome da série de TV.
partOfSeries.sameAs Texto Um URL para uma página da Web de referência que pode identificar o programa (por exemplo, a página da Wikipédia sobre ele). 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 no Video on Demand (VoD), essa propriedade será obrigatória. O objeto de marcação Ação precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal LiveTV, esta propriedade é opcional. A entidade BroadcastService associada fornece o link direto do canal.
  • Um TVSeason pode estar disponível em VoD e LiveTV.
Use uma matriz para especificar links diretos diferentes em várias regiões. Veja o exemplo em Várias regiões e idiomas.
sameAs URL Altamente recomendado Por quê? É um URL para uma página da Web de referência que pode identificar a temporada. Por exemplo, a página da temporada na Wikipédia. 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 cinematográfico 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 exemplo 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 este evento.

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

Para FeaturedEvent e ExclusiveEvent, essa é a região em que o conteúdo é destacado ou exclusivo.

Use códigos ISO 3166 para países. Para indicar em qualquer lugar do mundo, defina como EARTH.
releasedEvent.startDate Date ou DateTime Recomendado - obrigatório para ExclusiveEvent - a data de início da publicação da entidade.

Para um PublicationEvent, isso indica a data de lançamento inicial desta entidade, como a data em que um filme foi lançado nos cinemas pela primeira vez.

Para ExclusiveEvent e FeaturedEvent, representa a data de início de quando a entidade é exclusiva ou está 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 em que os direitos do conteúdo expiram.

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

Se o conteúdo for perpétuamente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organization ou Person Opcional: é a organização ou a pessoa que publicou a entidade.
description Texto Altamente recomendado Por quê? Uma sinopse da estação. Sinopses do enredo são preferenciais aos resumos factuais. Limite de 300 caracteres.
actor [Person, PerformingGroup ou PerformanceRole Altamente recomendado Por quê? Uma matriz dos membros do elenco da temporada. Veja aqui as orientações para modelagem.
director Person Altamente recomendado Por quê? Uma matriz dos 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, ["recurso, biografia"] pode ser uma matriz de palavras-chave para descrever o conteúdo.
trailer.description Texto A descrição do trailer. Veja o exemplo do trailer.
trailer.inLanguage Texto O idioma do trailer no formato BCP 47.
trailer.url URL O URL de um trailer hospedado publicamente e enviado por seus respectivos 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, ele será considerado permitido em todos os lugares. Especifique os países no formato ISO 3166.
identifier PropertyValue Altamente recomendado Por quê? - ID externo ou outro ID que identifica claramente essa entidade. Vários identificadores são permitidos. Consulte a seção Propriedades do identificador para mais detalhes.
popularityScore Pontuação de popularidade Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros sinais, para determinar qual mídia deve 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 entre os feeds, entre todas as entidades do seu catálogo. Por padrão, a pontuação de popularidade de uma entidade é definida como 0.
popularityScore.@type Texto Sempre definido como PopularityScoreSpecification.
popularityScore.value Número Um valor numérico não negativo que indica a popularidade da entidade. Uma pontuação mais alta significa mais popularidade.
popularityScore.eligibleRegion País Regiões em que essa pontuação de popularidade é aplicável. Se a pontuação de popularidade for globalmente aplicável, defina como EARTH. Por padrão, essa propriedade é definida como EARTH.
Note: A popularidade específica por localidade tem precedência sobre a popularidade global (EARTH)
review Review (em inglês) Avaliar classificações para a temporada de TV
review.reviewRating Classificação Obrigatório se review for fornecido. Ele é usado para especificar a classificação dada na avaliação.
contentRating Texto ou Classificação Obrigatório para conteúdo adulto, altamente recomendado: é a classificação geral do conteúdo. Se a classificação do conteúdo for fornecida na forma de uma string de texto, serão aceitas duas variações:
  • A agência de classificação precedeu a avaliação com um espaço em branco entre eles. Por exemplo, uma classificação "TV-MA" da agência "TVPG" nos EUA deve ser descrita como "TVPG TV-MA". Veja a lista de agências.
  • Um valor de "RATING NOT KNOWN" (não diferencia maiúsculas de minúsculas) para indicar que você não sabe a classificação do conteúdo.
contentRating.author Texto ou 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 de 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 consultivo do conteúdo. Os valores aceitos incluem D, FV, L, S e V. D = diálogo, FV = violência de fantasia , L = idioma, 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, juntamente com alguns exemplos que esclarecem o uso.

Propriedade Tipo esperado Descrição
actor Person, PerformingGroup ou PerformanceRole Altamente recomendado Por quê? : uma matriz dos membros do elenco.
  • Use o tipo PerformanceRole quando o papel for desempenhado e, como opção, o nome do personagem do membro do elenco. 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 dos grupos/faixas de desempenho quando as funções desempenhadas pelos membros do elenco são desconhecidas.

Use uma matriz para representar várias pessoas, PerformGroups ou PerformanceRoles.

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: defina sempre como Person ou PerformingGroup
@id URL Altamente recomendado Por quê? - Os atores ou o identificador do grupo de realização no formato URI, por exemplo, https://example.com/actor/abc. @id deve atender aos seguintes requisitos:
  • Exclusivo globalmente em seu catálogo por ator/grupo de apresentações
  • O código 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.
  • na forma de um Identificador de Recursos unificados (URI)
  • Sua organização precisa ser proprietária do domínio usado para o valor @id.

O @id usado na propriedade do ator precisa ser usado de forma consistente em todo o feed. Por exemplo, se houver dois filmes com o mesmo ator, o valor @id deve ser mantido em todos esses objetos.

name Texto Obrigatório: é o nome do grupo de atores/atrizes/membros do elenco/grupo de artistas.
sameAs URL Altamente recomendado Por quê? - Um URL para uma página da web de referência que pode identificar o ator ou o grupo de apresentação; 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 propriedades a seguir quando o tipo PerformanceRole for usado

Propriedade Tipo esperado Descrição
@type PerformanceRole (em inglês) Obrigatório: sempre definido como PerformanceRole
roleName Texto Altamente recomendado Por quê? - Um papel desempenhado, executado ou preenchido pelo membro do elenco. Veja a lista de valores aceitáveis aqui.
characterName Texto O nome de um personagem em algum papel de atuação ou interpretação. Não defina este 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.
  • Os grupos de desempenho/bandas do conteúdo quando o tipo de dados PerformingGroup é usado.
actor.@type Person ou PerformingGroup Obrigatório: defina sempre como Person ou PerformingGroup
actor.@id URL Altamente recomendado Por quê? - O ator ou o identificador do grupo de desempenho no formato URI, por exemplo, https://example.com/actor/abc. @id deve atender aos seguintes requisitos:
  • Exclusivo globalmente em seu catálogo por ator/grupo de apresentações
  • O código 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.
  • na forma de um Identificador de Recursos unificados (URI)
  • Sua organização precisa ser proprietária do domínio usado para o valor @id.

O @id usado na propriedade do ator precisa ser usado de forma consistente em todo o feed. Por exemplo, se houver dois filmes com o mesmo ator, o valor @id deve ser mantido em todos esses objetos.

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

Nomes de papéis aceitáveis

Esses valores exigem que actor.@type seja Person.

Valor roleName Descrição
“Cameo” Uma participação especial, também chamada de aparição, é uma breve aparição de uma pessoa conhecida em uma obra de arte cênica.
"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 o discurso de outro ator.
"Dobro" Um duplo é uma pessoa que substitui o rosto de outro ator para que o rosto da pessoa não seja mostrado.
"MotionCaptureActor" Um MotionCaptureActor se refere a uma pessoa gravando ações de atores humanos e usando 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 roleName Descrição
"Ator" Um ator ou atriz é uma pessoa que representa um personagem em uma apresentação no meio tradicional do teatro ou na mídia moderna, como cinema, rádio e televisão.
"Convidado especial" "Um ator convidado faz um papel fictício e aparece em um ou alguns episódios. Em alguns casos, um convidado pode participar de um importante personagem recorrente e aparecer várias vezes em uma série, mesmo não sendo membro do elenco principal. Defina o valor como "Convidado do cinema" quando o elenco tiver uma atuação como convidado ou for um convidado no programa. As estrelas de convidados só podem ser fornecidas no nível do episódio e não podem ser adicionadas no nível da TVSeries.
"Convidado" "Uma convidado em um programa de entrevistas. Embora "Convidado especial" seja um papel fictício, "Convidado" é uma aparição não fictícia.
"Anunciante" O locutor é quem transmite os momentos iniciais e finais do programa, apresenta o apresentador, os participantes e/ou os convidados celebridades, descreve os prêmios disponíveis, aquece o público antes de tocar e mantém a diversão durante os intervalos.
"Comentarista" Um comentarista fornece um comentário em tempo real sobre um jogo ou evento, geralmente durante uma transmissão ao vivo.
"Impressionista" Um impressionista ou um imitador é um artista cujo ato consiste em imitar sons, vozes e humorismo de celebridades e personagens de desenhos animados.
"Host" Uma pessoa que apresenta, apresenta ou hospeda programas de televisão, geralmente atuando como mediadora do programa e do público. O "host" geralmente é um papel de não ficção.
"CoHost" Uma pessoa que organiza um evento/programa em conjunto com outra pessoa.
"HostHost" Um anfitrião é um apresentador, geralmente de um programa de entrevistas, que hospeda o programa em vez do apresentador comum quando ele não está disponível.
"Espectador de notícias" Uma pessoa que apresenta/informa o público sobre notícias e eventos que acontecem em escala local, nacional e internacional por meio de um programa de notícias na TV.
"Correspondente" Um repórter ou repórter na cena normalmente é um jornalista ou comentarista de uma revista, um agente que contribui com reportagens para um jornal, notícias de rádio ou televisão ou outro tipo de empresa de um local remoto, muitas vezes distante.
"Julgamento Show" Um juiz é uma pessoa que geralmente é considerada especialista no campo do programa e tem o papel de "juiz" para criticar participantes que fizeram o teste e participaram da competição da série de TV.
"Painéis" Membro de um painel de discussão ou de consultoria de um painel de rádio ou televisão.
"Concorrente" Um participante de uma competição ou de uma competição é quem participa.
"Narrativa" O narrador é a pessoa que narra algo, especialmente um personagem que narra os acontecimentos de um romance ou poema narrativo.
"MusicalArtist" "Um artista musical pode ser uma pessoa, um grupo ou um personagem fictício que costuma se apresentar para o público regularmente ou que já gravou faixas musicais ou álbuns. Compositores e letristas só devem ter esse tipo se os créditos de uma obra musical insinuarem que eles também contribuam como artista principal. Esse tipo pode ser usado para associar músicos ou grupos de músicos permanentes a convidados ou apresentações de músicos.

Como diferenciar um papel principal de um ator

Para diferenciar os atores principal/normal e de convidado/suporte de um programa de TV, adicione o elenco principal somente em entidades TVSeries e inclua apenas o elenco de convidado ou o elenco com papéis de suporte 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 propriedade da Actor

A função do ator é desconhecida

Quando o papel de um ator é desconhecido, nossa recomendação é apenas fornecer 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"
    }
  ]

O papel do ator é conhecido

Quando a função de um ator é conhecida, nossa recomendação é 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"
      }
  }
]

Papéis conhecidos para o subconjunto de atores

Quando os metadados da função de desempenho não são conhecidos, nossa recomendação é fornecer as informações sobre o ator usando o tipo Person ou PerformingGroup . No 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 páginas a seguir para ver os tópicos relacionados a essas propriedades: