Gerar Schema VideoObject Sem Escrever JSON Manualmente
O schema de vídeo é um pequeno bloco de JSON-LD que informa ao Google que uma página possui um vídeo e qual é esse vídeo. O Google o lê para mostrar uma miniatura de vídeo nos resultados da pesquisa e listar o vídeo na aba Vídeos. Preencha os campos acima e o gerador escreverá o bloco VideoObject para você, sem colchetes para equilibrar e sem vírgula perdida que quebre silenciosamente a coisa toda.
Ele funciona no seu navegador. Os detalhes que você digita nunca são enviados, e não há necessidade de cadastro.
Campos obrigatórios marcados
Cada campo que o Google exige possui um marcador, para que você veja o que está faltando antes de copiar.
Mensagem de validade em tempo real
Abaixo do formulário, uma mensagem indica se a marcação está pronta para um resultado rico de vídeo ou se ainda precisa de uma URL reproduzível.
Duração escrita para você
Digite minutos e segundos simples. O gerador escreve a string ISO 8601, como PT6M30S.
Copiar ou baixar
Copie a tag de script, ou baixe-a como um arquivo .html para entregar a um desenvolvedor.
Os Campos que o Google Exige e os que Recomenda
A documentação de vídeo do Google exige três propriedades: name, thumbnailUrl and uploadDate. Todo o resto é recomendado. Entre os recomendados, quatro são importantes para quase todas as páginas: contentUrl, embedUrl, description and duration.
O Google precisa destes
name, o título do vídeo. thumbnailUrl, um link para a imagem em miniatura. uploadDate, quando foi publicado pela primeira vez. Sem os três, o vídeo não pode obter um resultado rico.
Adicione-os sempre que puder
contentUrl, um link direto para o arquivo de vídeo, ou embedUrl, um link para o player. Depois, description e duration. Uma URL reproduzível é o que permite ao Google buscar o próprio vídeo.
O gerador também pede uma descrição, porque o Google a recomenda e uma página com uma descrição real dá ao Google mais informações para trabalhar. Enquanto você digita, ele informa se você tem os campos obrigatórios mais uma URL reproduzível, ou apenas os campos obrigatórios.
O Que Cada Campo Significa
Nome
O título do vídeo. Use o título que os espectadores veem na página, não uma lista de palavras-chave.
Descrição
Uma ou duas frases sobre o que o vídeo mostra. Escreva para pessoas, não para o rastreador.
URL da Miniatura
Um link público para a imagem em miniatura. Deve carregar sem necessidade de login.
Data de upload
A data em que o vídeo foi publicado pela primeira vez, no formato AAAA-MM-DD.
Duração
Minutos e segundos. O gerador escreve como PT6M30S para seis minutos e trinta segundos.
URL do Conteúdo ou URL de Incorporação
Um link direto para o arquivo de vídeo, ou a URL do player, como o src de uma incorporação do YouTube.
O Que o Gerador Escreve
Esta é a forma da saída. O vídeo, as URLs e a data são inventados para este exemplo.
video-schema.html
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "Como Repotar uma Costela-de-Adão",
"description": "Passo a passo: escolhendo o vaso, soltando as raízes e a primeira rega.",
"thumbnailUrl": ["https://example.com/thumbs/repot-monstera.jpg"],
"uploadDate": "2026-09-30",
"duration": "PT6M30S",
"embedUrl": "https://www.youtube.com/embed/xxxx"
}
</script>Cole o bloco inteiro, incluindo a tag de script, no HTML da página onde o vídeo está. Tanto o <head> quanto o <body> funcionam. Ele não renderiza nada visível.
Permita que o Google consiga buscar o vídeo
Use uma URL pública
Sem login, sem link assinado que expire após uma hora.
Corresponda à página
O nome e a miniatura devem corresponder ao vídeo que as pessoas veem.
Teste a página ao vivo
Execute a URL através do Teste de Resultados Ricos após a publicação.
JSON válido é a parte fácil. Uma razão comum para a marcação de vídeo não gerar resultados é que o Google não consegue alcançar o arquivo ou a miniatura.
Como Adicionar Schema de Vídeo a uma Página
- Preencha os campos. Adicione o título, descrição, URL da miniatura e data de upload, depois a duração e uma URL de Conteúdo ou URL de Incorporação.
- Verifique a mensagem abaixo do formulário. Ela informa se a marcação tem tudo para um resultado rico de vídeo, ou qual parte está faltando.
- Copie ou baixe. Copie o código, ou baixe-o como um arquivo
.html, e cole-o na página onde o vídeo está. - Teste a página ao vivo. O Google recomenda validar seu código com the Rich Results Test. Execute a URL da página através dela e corrija quaisquer erros críticos.
Se a data de upload for desconhecida, o arquivo geralmente a possui. O analisador de metadados de vídeo lê a data de gravação de um MP4 ou MOV.
Momentos Chave: O Que Este Gerador Não Escreve
O Google pode mostrar momentos chave, links para pontos dentro de um vídeo, na pesquisa. Para isso, ele lê Clip markup, which marks segments by hand, or SeekToAction markup, which tells Google where timestamps go in your URL. Este gerador escreve um único VideoObject e não adiciona nenhum dos dois.
Se você quer momentos chave, você precisa dos carimbos de tempo primeiro. O ScreenApp pode fazer capítulos com carimbos de data/hora de um vídeo, e o gerador de capítulos AI do YouTube faz isso para vídeos do YouTube. Esses capítulos são os segmentos que você marcaria como itens Clip, ou mostraria em um vídeo do YouTube para que o Google possa pegá-los de lá.
O Que Ele Pode e Não Pode Fazer
Bom em
- Escrever um **bloco VideoObject limpo** a partir de um formulário curto
- Marcar os **campos que o Google exige** e dizer o que está faltando
- Escrever a **duração ISO 8601** a partir de minutos e segundos
- Manter tudo no seu navegador, sem upload e sem cadastro
Não construído para
- **Momentos chave:** ele não escreve marcação Clip ou SeekToAction
- **Ler seu vídeo:** você digita os detalhes, ele não os busca de um link
- **Publicação:** você cola o código em sua página ou CMS
- **Um resultado rico garantido:** o Google decide o que mostrar
A marcação válida torna um vídeo elegível para um resultado rico. Não o garante. O Google ainda decide o que mostrar para cada pesquisa, com base na consulta e na página.
Gerador de Esquema de Vídeo vs Outras Ferramentas
| Recurso | ScreenApp | Elfsight | Digispot |
|---|---|---|---|
| Cria a marcação no seu navegador, sem upload | Sim | Não declarado | Não declarado |
| Preenche campos de um link do YouTube | Não | Preenche the thumbnail and embed URL from a YouTube link | Não declarado |
| Marcação de momentos chave | Não | Não declarado | Tem a SeekToAction target URL field |
| Duração a partir de minutos e segundos simples | Sim | Não declarado | Não declarado |
| Copiar ou baixar como .html | Sim | Não declarado | Não declarado |
Sources, checked 2026-10-09: Elfsight video schema generator, Digispot video schema generator
- vs Elfsight: se o seu vídeo está no YouTube, o Elfsight preenche the thumbnail and embed URL from a YouTube link, o que economiza um passo. Você ainda digita o título, a descrição e a data. O ScreenApp faz você digitar todos os campos, e nada sai do seu navegador.
- vs Digispot: O Digispot tem a SeekToAction target URL field, então escolha-o se você quiser momentos chave do mesmo formulário. O ScreenApp escreve apenas o
VideoObjectcentral.
Depois da Marcação
Uma descrição que corresponde
O gerador de descrição de vídeo escreve a descrição do próprio vídeo.
Carimbos de tempo para momentos chave
O gerador de capítulos AI do YouTube encontra os capítulos que você marcaria como segmentos de Clipe.
Uma verificação de título e descrição
O analisador de SEO de vídeo revisa o texto que decide se as pessoas clicam.
Uma transcrição na página
O gerador de transcrição online fornece texto que leitores e rastreadores podem usar.
Quem Usa um Gerador de Esquema de Vídeo
Proprietários de sites e blogueiros que incorporam um vídeo em uma postagem e querem que ele apareça com uma miniatura no Google, sem instalar um plugin para uma única página.
Especialistas em SEO que precisam de um bloco VideoObject rápido e limpo para entregar a um desenvolvedor ou colar em um campo do CMS.
Desenvolvedores que querem um exemplo correto para copiar a estrutura antes de gerarem a marcação a partir de um template.
Profissionais de marketing com vídeos de produtos e tutoriais em landing pages, onde o vídeo é o conteúdo principal da página.
