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