Gerador de schema de vídeo

Como gerar o schema de vídeo

Três propriedades obrigatórias, um formato de data em que quase todo mundo tropeça e dois campos de URL que não são a página em que você está. O gerador escreve a marcação e o bloco de legenda a partir dos mesmos valores.

1. Título e miniatura primeiro. Os dois são obrigatórios e precisam ser exclusivos deste vídeo. A miniatura só serve ao Google se a URL continuar a mesma no mês que vem — CDN que troca de URL custa a indexação do vídeo.
2. Dê fuso à hora de publicação. A data sozinha é válida; data, hora e fuso não deixam dúvida. No Brasil, o horário de Brasília é -03:00 o ano todo; sem fuso, o Google usa o do Googlebot.
3. Digite a duração do jeito que você pensa nela. Dezesseis e cinco, uma hora e dois minutos, uma contagem de segundos ou a forma ISO. A saída é sempre a duração ISO 8601 que a propriedade espera.
4. contentUrl no arquivo, embedUrl no player. Nenhum dos dois é a página em que o leitor está. O gerador recusa um contentUrl com cara de página web, porque esse é o erro mais comum em marcação de vídeo.
5. Adicione capítulos e cole as duas saídas. Os links dos capítulos saem da URL da página de exibição com um parâmetro de tempo, a forma que o Google exige. O JSON-LD vai na página de exibição; o bloco de legenda, com a tabela de capítulos, vai embaixo do player.

uploadDate e o fuso: −03:00 em Brasília, o ano inteiro

Um gerador de schema de vídeo transforma os dados de um vídeo em JSON-LD VideoObject — os dados estruturados que o Google lê para o título, a miniatura, a duração e os Momentos importantes de um vídeo. Três propriedades são obrigatórias: name, thumbnailUrl e uploadDate. A terceira é onde a marcação erra sem ninguém ver.

A documentação diz que uploadDate é a data e a hora da primeira publicação, em ISO 8601, e completa: recomendamos que você forneça informações de fuso horário; caso contrário, o padrão vai ser o fuso horário usado pelo Googlebot. Para quem publica no Brasil, a resposta está na lei. O território tem quatro fusos (Decreto 2.784/1913, com a redação da Lei 12.876/2013):

Não há horário de verão desde o Decreto 9.772/2019, que encerrou a hora de verão no território nacional; o Ministério de Minas e Energia a descreve como suspensa e avaliada periodicamente. O detalhe pega quem preenche o catálogo antigo: até 2019, um vídeo publicado no verão — em geral de outubro ou novembro até meados de fevereiro, conforme o ano — no Sul, no Sudeste ou no Centro-Oeste estava no horário de verão; em São Paulo, −02:00. Escolha -02:00 nessas datas em vez de carimbar −03:00 em tudo — os quatro fusos brasileiros estão no menu do gerador.

"uploadDate": "2026-08-14"                    // válido, sem hora nenhuma
      "uploadDate": "2026-08-14T20:00:00"           // hora, mas de qual relógio?
      "uploadDate": "2026-08-14T20:00:00-03:00"     // sem dúvida

A mesma recomendação vale para expires, com uma instrução que costuma ser ignorada: não informe expires se o vídeo não vai sair do ar. Validade vazia ou num futuro distante não é neutra — é uma afirmação.

Duração é duração, contentUrl é arquivo — e o caso do YouTube

duration recebe uma duração ISO 8601, não uma hora do relógio nem um número de segundos: PT00H30M5S são 30 minutos e 5 segundos, no exemplo do próprio Google. Este formulário aceita o que você tiver — 16:05, 1:02:30, 965 ou a forma ISO — e entrega a ISO. Valor que ele não consegue ler vira erro, não passa adiante.

As duas propriedades de URL são onde a marcação de vídeo mais falha em silêncio:

• contentUrl é a URL dos bytes do arquivo de vídeo. O texto do Google é explícito: não crie um link para a página em que o vídeo está localizado. A URL deve terminar num dos 21 tipos que o Google processa — mp4, webm, mov, mkv, m3u8 e outros — e não pode ser uma URL de dados.
• embedUrl é o player, geralmente o que está no src do elemento de incorporação. Também não é a página.
• O Google recomenda contentUrl sempre que possível, porque é a forma mais eficaz de ele buscar o vídeo; embedUrl é a alternativa.

Com o vídeo no YouTube, você não tem o arquivo: fica só o embedUrl, no formato https://www.youtube.com/embed/ seguido do ID do vídeo, que é a URL que a documentação do YouTube manda pôr no src do iframe. Segundo o Google, quando um site incorpora player de terceiros como YouTube, Vimeo ou Facebook, o vídeo pode ser indexado tanto na sua página quanto na página equivalente da plataforma, e ele recomenda os dados estruturados na sua página de exibição mesmo assim. Os Momentos importantes de um vídeo hospedado no YouTube, porém, vêm das marcações de tempo na descrição do próprio YouTube.

Este gerador trata como erro, não como aviso, um contentUrl sem extensão de arquivo ou com cara de HTML. Numa página que valida em tudo o mais, esse campo costuma ser o motivo de o vídeo nunca aparecer.

Miniatura e capítulos, com os números que o Google publica

Capítulos são o tipo Clip dentro de hasPart, e trazem uma regra que muita ferramenta pula: o URL do clipe precisa apontar para o mesmo caminho do URL que o vídeo com parâmetros de consulta adicionais que especificam o tempo. Informe a URL da página de exibição e cada capítulo sai como essa URL mais ?t= e o início em segundos — nada de fragmento, outro domínio ou link solto. O gerador também recusa um capítulo que começa depois do fim do vídeo, que é como um erro de digitação na minutagem aparece do lado do Google.

A documentação traz mais três limites. Dois clipes do mesmo vídeo, na mesma página, não podem começar no mesmo segundo — esse o gerador pega, como capítulo fora de ordem. Os outros dois ficam com você: o vídeo precisa ter no mínimo 30 segundos para receber Clip e precisa aceitar link direto para um ponto que não seja o início. O Clip funciona em todos os idiomas em que a Pesquisa Google existe; a alternativa automática, SeekToAction, está disponível em português, entre outros idiomas.

Página de exibição, player de terceiros e o bloco de legenda

A marcação descreve um vídeo que está na página; ela não o cria. Para os recursos de vídeo, o Google pede que a página de exibição esteja indexada — e avisa que página indexada não significa vídeo indexado —, que o vídeo esteja incorporado nela e não fique escondido atrás de outros elementos, e que o carregamento não dependa de ação do usuário, como deslizar, clicar ou digitar. Player que só aparece depois de um clique na capa cai exatamente nessa regra.

Vale o mesmo para qualquer plataforma que você incorpore, seja Kwai, TikTok ou Instagram: o Google encontra vídeos referenciados por <video>, <embed>, <iframe> ou <object>, e, se o player é injetado por JavaScript, o vídeo precisa aparecer no HTML renderizado da Ferramenta de inspeção de URL.

Por isso existe a segunda saída. Uma página de exibição cuja única descrição do vídeo está dentro de uma tag script não dá nada ao leitor, não dá a um mecanismo de resposta com IA nada para citar e não deixa você perceber que a marcação envelheceu. Título, descrição, data de publicação, duração e a tabela de capítulos, visíveis e com as mesmas minutagens, se conferem num olhar. A mesma regra — uma fonte, duas saídas — está no gerador de schema FAQ; e, se o vídeo mostra uma receita, a propriedade video da Recipe recebe este mesmo VideoObject, como explica o gerador de schema de receita.