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 TVSeries, TVSeason e TVEpisódio para mais detalhes.

Tabela de especificações

TVSeries

Propriedade Tipo esperado Descrição
@context Texto Obrigatório – Sempre defina como ["http://schema.org", {"@language": "xx"}]
  • Onde" xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre defina 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 no seu catálogo
  • O ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade de URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • O domínio usado para o valor @id precisa ser da sua organização.
Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela 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 ao conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico em funcionamento que possa ser rastreado pelo Google.
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 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 que representa, no nível mais geral/abstrato, uma obra de filme ou televisão.

Por exemplo, o titleEIDR da TVSeries é conhecido 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 em vídeo on demand (VoD), essa propriedade será obrigatória. O objeto de marcação "Action" precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal de LiveTV, essa propriedade será 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 diferentes links diretos em várias regiões. Veja o exemplo Várias regiões e idiomas.
sameAs URL Altamente recomendado Por quê? Um URL para uma página da web de referência que possa identificar o programa. por exemplo, a página do programa na Wikipédia. Ela 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. Também é permitido usar uma matriz 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 recomendado Por quê? - Um PublicationEvent é usado para especificar o lançamento original (global ou local) do conteúdo por um editor, como a data original de lançamento no cinema de um filme.

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 exemplo para 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 uma PublicationEvent, é a região onde o conteúdo foi publicado.

Para FeaturedEvent e ExclusiveEvent, é a região onde o conteúdo é apresentado ou exclusivo.

Use os códigos ISO 3166 para os 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 PublicationEvent, isso indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado nos cinemas.

Para ExclusiveEvent e FeaturedEvent, representa a data de início em que a entidade é exclusiva ou exibida em destaque.
releasedEvent.endDate Date ou DateTime Recomendado – Obrigatório para ExclusiveEvent: aplicável apenas aos tipos ExclusiveEvent e FeaturedEvent.

Para ExclusiveEvent, isso 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 permanentemente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organização ou Pessoa Opcional: a organização ou pessoa que publicou a entidade.
description Texto Altamente recomendado Por quê? Uma sinopse do programa. Sinopses do enredo são preferidas em vez de resumos factuais. Limite de 300 caracteres.
actor Person, PerformingGroup ou PerformanceRole Altamente recomendado Por quê? Uma matriz do elenco da série. Confira as orientações de modelagem aqui.
director Person Altamente recomendado Por quê? Os diretores do programa.
producer Organização ou Pessoa Altamente recomendado Por quê? Os produtores do programa.
image ImageObject Obrigatório para o Google TV: são 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. Veja o exemplo do Trailer.
trailer.inLanguage Texto 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 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 PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia vai ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos do seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no 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. uma pontuação mais alta significa maior 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 popularidade global (EARTH)
review Review (em inglês) Revisar 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 Text ou Rating Obrigatório para conteúdo adulto, altamente recomendado: classificação geral do conteúdo. Se a classificação do conteúdo for dada na forma de uma string de texto, duas variações serão aceitas:
  • A agência precedida pela classificação com um espaço em branco no meio. Por exemplo, "TV-MA" classificação da agência "TVPG" nos EUA deve ser descrito como "TVPG TV-MA". Consulte a lista de agências.
  • Um valor de "CLASSIFICAÇÃO NÃO CONHECIDA" (não diferencia maiúsculas de minúsculas) para indicar que você não sabe a classificação do conteúdo.
contentRating.author Organização Obrigatório se contentRating usar Rating: é o nome da agência de classificação. Consulte a página Agências de classificação de conteúdo para ver uma lista de agências 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 fantasiosa, L = idioma, S = conteúdo sexual, V = violência.

TVEpisode

Propriedade Tipo esperado Descrição
@context Texto Obrigatório – Sempre defina como ["http://schema.org", {"@language": "xx"}]
  • Onde" xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre defina 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 no seu catálogo
  • O ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade de URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • O domínio usado para o valor @id precisa ser da sua organização.
Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela 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 ao conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico em funcionamento que possa ser rastreado pelo Google.
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 que representa, no nível mais geral/abstrato, uma obra de filme ou televisão.

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

Por exemplo, o primeiro episódio da primeira temporada de TVSeries, conhecido como "Game of Thrones", com o 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 o EIDR da 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 na ordem dos episódios de uma temporada. episodeNumber precisa ser reiniciado para cada temporada. Ou seja, o primeiro episódio de cada temporada precisa ser um.
partOfSeason TVSeason Obrigatório: a temporada de TV a que o 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: sempre defina como TVSeason.
partOfSeason.@id URL Obrigatório: o @id do TVSeason de que o 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 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 defina como TVSeries.
partOfSeries.@id URL Obrigatório: o @id do TVSeries de que o 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 possa identificar o programa. por exemplo, a página do programa na Wikipédia. Ela precisa ser diferente da propriedade url.
potentialAction WatchAction Obrigatório, se aplicável: um objeto de marcação de ação que fornece os detalhes da ação.
  • Se o conteúdo estiver disponível em vídeo on demand (VoD), essa propriedade será obrigatória. O objeto de marcação "Action" precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal de LiveTV, essa propriedade será 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 diferentes links diretos em várias regiões. Veja o exemplo Várias regiões e idiomas.
sameAs Altamente recomendado Por quê? URL Um URL para uma página da Web de referência que possa identificar o episódio. por exemplo, a página do episódio na Wikipédia. Ela 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) do conteúdo por um editor, como a data original de lançamento no cinema de um filme.

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 exemplo para 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 uma PublicationEvent, é a região onde o conteúdo foi publicado.

Para FeaturedEvent e ExclusiveEvent, é a região onde o conteúdo é apresentado ou exclusivo.

Use os códigos ISO 3166 para os 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 PublicationEvent, isso indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado nos cinemas.

Para ExclusiveEvent e FeaturedEvent, representa a data de início em que a entidade é exclusiva ou exibida em destaque.
releasedEvent.endDate Date ou DateTime Recomendado – Obrigatório para ExclusiveEvent: aplicável apenas aos tipos ExclusiveEvent e FeaturedEvent.

Para ExclusiveEvent, isso 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 permanentemente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organização ou Pessoa Opcional: a organização ou pessoa que publicou a entidade.
description Texto Altamente recomendado Por quê? Uma sinopse do episódio. Sinopses do enredo são preferidas em vez de 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. Também é permitido usar uma matriz de palavras-chave. Por exemplo, ["feature, biography"] 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. Confira as orientações de modelagem aqui.
director Person Altamente recomendado Por quê? Os diretores do episódio.
producer Organização ou Pessoa Altamente recomendado Por quê? Produtor da temporada.
image ImageObject Altamente recomendado Por quê? para 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 Um URL de um trailer hospedado publicamente e enviado pelos 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) Revisar 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 Text ou Rating Obrigatório para conteúdo adulto, altamente recomendado: classificação geral do conteúdo. Se a classificação do conteúdo for dada na forma de uma string de texto, duas variações serão aceitas:
  • A agência precedida pela classificação com um espaço em branco no meio. Por exemplo, "TV-MA" classificação da agência "TVPG" nos EUA deve ser descrito como "TVPG TV-MA". Consulte a lista de agências.
  • Um valor de "CLASSIFICAÇÃO NÃO CONHECIDA" (não diferencia maiúsculas de minúsculas) para indicar que você não sabe a classificação do conteúdo.
contentRating.author Organização Obrigatório se contentRating usar Rating: é o nome da agência de classificação. Consulte a página Agências de classificação de conteúdo para ver uma lista de agências 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 fantasiosa, 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 PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia vai ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos do seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no 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. uma pontuação mais alta significa maior 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 popularidade global (EARTH)

TVSeason

Propriedade Tipo esperado Descrição
@context Texto Obrigatório – Sempre defina como ["http://schema.org", {"@language": "xx"}]
  • Onde" xx" representa o idioma das strings no feed. Cada contexto de entidade raiz precisa ter @language definido com o código de idioma adequado no formato BCP 47. Por exemplo, se o idioma estiver definido como espanhol, os nomes serão considerados em espanhol, mesmo que o idioma da legenda/dublagem esteja em inglês.
@type Texto Obrigatório: sempre defina 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 no seu catálogo
  • O ID precisa ser estável e não pode mudar ao longo do tempo, mesmo que a propriedade de URL do programa mude. Ele será tratado como uma string opaca e não precisa ser um link em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • O domínio usado para o valor @id precisa ser da sua organização.
Como o url de uma entidade atende a todos os requisitos de identificador, recomendamos que você use o url dela 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 ao conteúdo dos bancos de dados do Google.
url precisa atender aos seguintes requisitos:
  • url precisa ser globalmente exclusivo
  • url precisa conter um URL canônico em funcionamento que possa ser rastreado pelo Google.
Para o link direto da reprodução, consulte a propriedade urlTemplate do objeto de destino.
name Texto Obrigatório: o nome da 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 que representa, no nível mais geral/abstrato, uma obra de filme ou televisão.

Por exemplo, o título EIDR da primeira temporada de TVSeries conhecida 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 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 defina 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 possa identificar o programa. por exemplo, a página do programa na Wikipédia. Ela precisa ser diferente da propriedade url.
potentialAction WatchAction Obrigatório, se aplicável: um objeto de marcação de ação que fornece os detalhes da ação.
  • Se o conteúdo estiver disponível em vídeo on demand (VoD), essa propriedade será obrigatória. O objeto de marcação "Action" precisa fornecer o link direto do conteúdo.
  • Se o conteúdo estiver disponível em um canal de LiveTV, essa propriedade será 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 diferentes links diretos em várias regiões. Veja o exemplo Várias regiões e idiomas.
sameAs URL Altamente recomendado Por quê? Um URL para uma página da Web de referência que possa identificar a temporada. por exemplo, a página da temporada da Wikipédia. Ela 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) do conteúdo por um editor, como a data de lançamento original no cinema 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 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 uma PublicationEvent, é a região onde o conteúdo foi publicado.

Para FeaturedEvent e ExclusiveEvent, é a região onde o conteúdo é apresentado ou exclusivo.

Use os códigos ISO 3166 para os 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 PublicationEvent, isso indica a data de lançamento inicial da entidade, como a data em que um filme foi lançado nos cinemas.

Para ExclusiveEvent e FeaturedEvent, representa a data de início em que a entidade é exclusiva ou exibida em destaque.
releasedEvent.endDate Date ou DateTime Recomendado – Obrigatório para ExclusiveEvent: aplicável apenas aos tipos ExclusiveEvent e FeaturedEvent.

Para ExclusiveEvent, isso 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 permanentemente exclusivo ou em destaque, defina endDate como 20 anos a partir da data atual.
releasedEvent.publishedBy Organização ou Pessoa Opcional: a organização ou pessoa que publicou a entidade.
description Texto Altamente recomendado Por quê? Uma sinopse da temporada. Sinopses do enredo são preferidas em vez de resumos factuais. Limite de 300 caracteres.
actor [Person, PerformingGroup ou PerformanceRole Altamente recomendado Por quê? Uma matriz dos membros do elenco da temporada. Confira as orientações de modelagem aqui.
director Person Altamente recomendado Por quê? Uma matriz dos diretores do programa.
producer Organização ou Pessoa Altamente recomendado Por quê? Produtor 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. Também é permitido usar uma matriz de palavras-chave. Por exemplo, ["feature, biography"] 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 Um URL de um trailer hospedado publicamente e enviado pelos 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 PopularityScoreSpecification Altamente recomendado Por quê? Uma pontuação que o Google usa, além de outros indicadores, para determinar qual mídia vai ser reproduzida para os usuários. Essa pontuação representa a popularidade do conteúdo em relação a outros conteúdos do seu catálogo. Portanto, a escala da pontuação precisa ser consistente nos feeds e entre todas as entidades no 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. uma pontuação mais alta significa maior 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 popularidade global (EARTH)
review Review (em inglês) Revisar 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 Text ou Rating Obrigatório para conteúdo adulto, altamente recomendado: classificação geral do conteúdo. Se a classificação do conteúdo for dada na forma de uma string de texto, duas variações serão aceitas:
  • A agência precedida pela classificação com um espaço em branco no meio. Por exemplo, "TV-MA" classificação da agência "TVPG" nos EUA deve ser descrito como "TVPG TV-MA". Consulte a lista de agências.
  • Um valor de "CLASSIFICAÇÃO NÃO CONHECIDA" (não diferencia maiúsculas de minúsculas) para indicar que você não sabe a classificação do conteúdo.
contentRating.author Organização Obrigatório se contentRating usar Rating: é o nome da agência de classificação. Consulte a página Agências de classificação de conteúdo para ver uma lista de agências 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 fantasiosa, 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 mostram o mesmo modelo, 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 desempenhado e, opcionalmente, o nome dos personagens dos membros do elenco for conhecido. Nesse caso, o agente Person ou PerformingGroup é incorporado dentro do objeto PerformanceRole.
  • Use o tipo Person para indicar os atores individuais ou o PerformingGroup para fornecer detalhes dos grupos/bandas de execução quando os papéis desempenhados pelos membros do elenco forem desconhecidos.

Use uma matriz para representar várias pessoas, grupos de execução ou papéis de desempenho.

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 defina como Person ou PerformingGroup.
@id URL Altamente recomendado Por quê? - Os atores ou identificadores de grupo em formato de URI; por exemplo, https://example.com/actor/abc. @id deve atender aos seguintes requisitos:
  • Exclusivo globalmente no seu catálogo por ator/grupo de performance
  • O ID precisa ser estável e não pode mudar ao longo do tempo. Ele será tratado como uma string opaca e não precisa ser um link em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • 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 de @id precisará ser mantido em todos esses objetos de ator.

name Texto Obrigatório: o nome do ator/atriz/membro do elenco/grupo de performance.
sameAs URL Altamente recomendado Por quê? - Um URL para uma página da web de referência que possa identificar o ator ou o grupo de artistas; por exemplo, a página da Wikipédia do ator. Ela precisa ser diferente da propriedade @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 defina como PerformanceRole
roleName Texto Altamente recomendado Por quê? - Um papel desempenhado, interpretado ou preenchido pelo membro do elenco. Consulte a lista de valores aceitáveis aqui.
characterName Texto O nome de um personagem interpretado ou por um papel. 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/bandas de execução do conteúdo quando o tipo de dados PerformingGroup é usado.
actor.@type Person ou PerformingGroup Obrigatório: sempre defina como Person ou PerformingGroup.
actor.@id URL Altamente recomendado Por quê? - O identificador do ator ou do grupo executor no formato URI; por exemplo, https://example.com/actor/abc. @id deve atender aos seguintes requisitos:
  • Exclusivo globalmente no seu catálogo por ator/grupo de performance
  • O ID precisa ser estável e não pode mudar ao longo do tempo. Ele será tratado como uma string opaca e não precisa ser um link em funcionamento.
  • Na forma de URI (Identificador de recurso unificado)
  • 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 de @id precisará ser mantido em todos esses objetos de ator.

actor.name Texto Obrigatório: o nome do ator/atriz/membro do elenco/grupo de performance.
actor.sameAs URL Altamente recomendado Por quê? - Um URL para uma página da web de referência que possa identificar o ator ou o grupo de artistas; por exemplo, a página da Wikipédia do ator. 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 breve, é a aparição breve de uma pessoa conhecida em uma obra de arte cênica.
"Dubladora" A narração é quando a voz do ator é usada, mas ele não aparece na tela. Isso é mais comumente encontrado em animações, mas também ocorre quando a voz de um ator é dublada em vez da fala de outro ator.
"Dobro" Um duplo é uma pessoa que substitui outro ator, de modo que o rosto da pessoa não é mostrado.
"MotionCaptureActor" Uma 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 computacional 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 retrata um personagem em uma apresentação no meio tradicional do teatro ou na mídia moderna, como cinema, rádio e televisão.
"GuestStar" "Um convidado é um ator que desempenha um papel fictício e aparece em um ou alguns episódios. Em alguns casos, um convidado pode desempenhar um personagem recorrente importante e aparecer várias vezes em uma série, mesmo não sendo membro do elenco principal. Definir o valor como "GuestStar" quando o elenco tem participação especial ou participa do programa. As estrelas convidadas só devem ser fornecidas no nível do episódio, e não no nível da série de TV.
"Convidado" "Um convidado de um talk show. Observe que, embora "GuestStar" é um papel fictício, "Convidado" é uma aparência não fictícia.
"Anunciante" Um locutor é uma pessoa que faz discursos de abertura e encerramento para o programa, apresenta o apresentador, os competidores e/ou celebridades, descreve os prêmios disponíveis, aquece o público antes da gravação e os mantém entretidos durante os intervalos.
"Comentador" Um comentarista oferece comentários em tempo real sobre um jogo ou evento, geralmente durante uma transmissão ao vivo.
"Impressionista" Um impressionista ou imitador é um artista que imita sons, vozes e maneirismos de celebridades e personagens de desenho animado.
"Apresentador" Uma pessoa que apresenta, apresenta ou apresenta programas de televisão, muitas vezes atuando como mediador do programa e do público. O "apresentador" geralmente não é um papel de não ficção.
"Coapresentador" Uma pessoa que organiza um evento/programa em conjunto com outra pessoa.
"Convidado" Um apresentador convidado é um apresentador, geralmente de um talk show, que apresenta o programa em vez do anfitrião normal quando não está disponível.
"Apresentador" Uma pessoa que apresenta/informa ao público sobre notícias e eventos em escala local, nacional e internacional por meio de um programa de notícias na TV.
"Correspondente" Um correspondente ou repórter em cena geralmente é jornalista ou comentarista de uma revista, ou um agente que contribui com reportagens para um jornal, noticiário de rádio ou televisão, ou outro tipo de empresa, de um local remoto, muitas vezes distante.
"ShowJudge" Um juiz é uma pessoa que muitas vezes é considerada um especialista na área do espetáculo e recebe o papel de "juiz" criticar os concorrentes que vão fazer testes e participar da competição da série de TV.
"Participante do painel" Membro de um painel de discussão ou consultoria de um painel de rádio ou televisão.
"Concorrente" Um competidor de uma competição ou game show é uma pessoa que participa de uma competição.
"StoryNarrator" (Narrador de História) Narrador é uma pessoa que narra algo, especialmente um personagem que relata os eventos de um romance ou poema narrativo.
"Artista musical" "Um artista musical pode ser uma pessoa, um grupo ou um personagem fictício que normalmente se apresenta para um público regularmente ou tem faixas ou álbuns musicais gravados. Compositores e letristas só devem escolher esse tipo se os créditos de alguma obra musical indicarem que eles também contribuem como artista principal. Este tipo pode ser usado para associar músicos ou grupos permanentes e convidados ou grupos de músicos a shows.

Diferenciar entre um ator principal e um coadjuvante

Para diferenciar entre os atores principais/regulares e convidados/auxiliares de um programa de TV, adicione o elenco principal somente em entidades TVSeries e adicione apenas o elenco convidado ou com papéis secundários nas entidades TVEpisode. Verifique se a transmissão principal/regular não foi adicionada à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 Actor

O papel do ator é desconhecido

Quando a função de um ator é desconhecida, recomendamos fornecer as informações dele 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, 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 por um subconjunto de atores

Quando os metadados dos papéis de performance não são conhecidos, recomendamos fornecer as informações dos atores usando o tipo Person ou PerformingGroup . Para o outro caso em que essa informação é conhecida, use o tipo PerformanceRole . Esses tipos podem ser adicionados juntos na mesma matriz.

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

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