Campos

Preenche as URLs do player e da miniatura a partir do ID do vídeo – nenhuma requisição é feita.
O nome como aparece na página.
Uma descrição curta que corresponda ao texto visível.
Exigido pelo Google. Pelo menos 60×30 px, rastreável.
Data e hora em que o vídeo foi publicado pela primeira vez.
Diferença de horário adicionada às datas. Sem ela, o Google usa o fuso horário do Googlebot.
m:ss ou h:mm:ss – convertido para ISO 8601 (PT12M47S).
Um link direto para o arquivo de mídia.
A URL do player incorporável (src do iframe).
Só se o vídeo deixar de estar disponível.
Exibido como interactionStatistic (WatchAction).
Códigos ISO separados por vírgula; deixe vazio se estiver disponível em todo lugar.

Momentos-chave

Marque os capítulos você mesmo (Clip) ou deixe o Google encontrá-los (SeekToAction com um modelo de URL).

Transmissão ao vivo

Adiciona BroadcastEvent para o selo AO VIVO.

JSON-LD

Verificando… ·

Os arquivos nunca saem do seu navegadorComo?

Marcação VideoObject com momentos-chave e transmissões ao vivo

Este gerador de schema de vídeo escreve o JSON-LD VideoObject de uma página que hospeda ou incorpora um vídeo. Preencha título, miniaturas e data de upload, inclua momentos-chave ou uma transmissão ao vivo e copie o script validado.

Última atualização:

Como funciona

  1. Comece pelo vídeo

    Cole um link do YouTube e clique em Preencher do YouTube para obter as URLs do player e da miniatura, ou informe as URLs do seu arquivo e do seu player.

  2. Título, data e duração

    Digite a duração como 12:47 ou 1:02:03 – ela vira PT12M47S. A data de upload recebe o fuso horário escolhido.

  3. Momentos-chave ou ao vivo

    Liste clipes com início e fim, ou dê um modelo de URL para momentos-chave automáticos; marque transmissões ao vivo para o selo AO VIVO.

Recursos

  • Link do YouTube vira URLs

    O id é extraído de links watch, youtu.be, shorts ou embed e transformado em URLs de incorporação e de miniatura – por regras de texto, sem contatar o YouTube.

  • Clipes como capítulos

    Cada clipe tem nome, início e fim em m:ss (gravados em segundos) e uma URL que abre o vídeo naquele ponto.

  • SeekToAction

    Para momentos-chave automáticos, o modelo de URL precisa conter {seek_to_second_number}; a anotação startOffset-input é incluída para você.

  • Transmissões ao vivo

    Um BroadcastEvent com isLiveBroadcast e horários de início e fim deixa a live qualificada para o selo AO VIVO.

Limites e privacidade

O JSON-LD ou HTML importado pode ter até 1 MB. O formulário cobre um vídeo por página; páginas com vários vídeos precisam de um VideoObject para cada um, combinados no JSON.

As URLs de miniatura e de vídeo não são acessadas nem verificadas. Miniaturas derivadas de um id do YouTube usam os nomes de imagem padrão do YouTube; maxresdefault não existe em todo vídeo, por isso hqdefault também entra na lista.

A validação usa o vocabulário schema.org (© patrocinadores do schema.org, CC BY-SA 3.0, veja as licenças). Tudo fica no seu navegador – saiba mais na página de privacidade.

Perguntas frequentes

Quais propriedades de vídeo o Google exige?

name, thumbnailUrl e uploadDate. Recomendados são description, duration, contentUrl ou embedUrl e interactionStatistic.

Preciso de marcação para vídeos do YouTube incorporados?

O Google muitas vezes detecta sozinho vídeos do YouTube incorporados, mas a marcação descreve o vídeo da sua página de forma explícita e acrescenta momentos-chave e datas.

Clip ou SeekToAction?

Clip quando você mesmo define os capítulos. SeekToAction quando o Google pode achar os momentos-chave sozinho e o seu player pula para qualquer segundo pela URL.

Como se escreve a duração?

Em ISO 8601: PT1M54S é 1 minuto e 54 segundos. Digite 1:54 aqui e a conversão é automática.

O vídeo precisa ser o conteúdo principal da página?

Para os recursos de vídeo na Pesquisa, sim: ele deve estar em destaque e fácil de encontrar, não escondido em uma barra lateral.

Ferramentas relacionadas