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"}]
|
@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:
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:
urlTemplate do objeto target. |
name |
Texto | Obrigatório: o nome do programa.
|
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.
|
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:
|
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:
|
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"}]
|
@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:
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:
urlTemplate do objeto target. |
name |
Texto | Obrigatório: o nome do episódio.
|
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 é:
|
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.
|
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:
|
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:
|
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"}]
|
@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:
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:
urlTemplate do objeto target. |
name |
Texto | Obrigatório: o nome desta temporada de TV.
|
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.
|
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:
|
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:
|
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 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:
O |
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 :
|
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:
O |
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"
}
]
Páginas relacionadas
Confira as seguintes páginas para ver os tópicos relacionados a essas propriedades: