Dados estruturados de vídeo (VideoObject, Clip, BroadcastEvent)

Embora o Google tente entender automaticamente os detalhes do vídeo, é possível marcar o vídeo com VideoObject para influenciar as informações que aparecem nos resultados, como a descrição, o URL da miniatura, a data do upload e a duração. Adicionar dados estruturados de vídeo às suas páginas de exibição também pode facilitar a descoberta do vídeo pelo Google. Os vídeos podem aparecer em vários locais diferentes no Google, incluindo a página principal de resultados da pesquisa, o modo de vídeo, o Imagens do Google e o Google Discover:

Conteúdo de vídeo nos resultados da pesquisa do Google, na guia de vídeo e no Discover

Com base na marcação da página de exibição, seus vídeos também podem se qualificar para os seguintes recursos de vídeo específicos:

Recursos de vídeo

Selo AO VIVO: marque o vídeo com BroadcastEvent para adicionar um selo AO VIVO a ele. O selo AO VIVO pode ser aplicado a vídeos públicos transmitidos ao vivo com qualquer duração. Veja alguns exemplos:

  • Eventos esportivos
  • Premiações
  • Vídeos de influenciadores
  • Jogos com streaming de vídeo ao vivo

Siga as diretrizes do selo AO VIVO e use a API Indexing para garantir que o Google rastreie a página no momento certo.

Vídeos com selo AO VIVO nos resultados da pesquisa

Momentos importantes

O recurso Momentos importantes é uma maneira de navegar por segmentos de vídeo como capítulos em um livro, o que pode ajudar os usuários a interagir mais profundamente com o conteúdo. A Pesquisa Google tenta detectar automaticamente os segmentos dos vídeos e mostrar os Momentos importantes para os usuários sem que você precise fazer nada. Como alternativa, é possível informar manualmente ao Google sobre os pontos importantes do vídeo. Priorizamos os Momentos importantes definidos por você, seja em dados estruturados ou na descrição do YouTube.

  • Se o vídeo estiver incorporado à sua página da Web ou se você tiver uma plataforma de vídeo, há duas maneiras de ativar os Momentos importantes:
    • Dados estruturados Clip: especifique o ponto de início e de término exatos para cada segmento, assim como o rótulo que será exibido em cada um. Esse recurso está disponível em todos os idiomas em que é possível acessar a Pesquisa Google.
    • Dados estruturados SeekToAction: informe onde as marcações de tempo geralmente são inseridas na estrutura do seu URL para que o Google possa identificar de modo automático os Momentos importantes e vincular os usuários a esses pontos do vídeo. Esse recurso está disponível nos seguintes idiomas: inglês, espanhol, português, italiano, chinês, francês, japonês, alemão, turco, coreano, holandês e russo.
  • Se o vídeo estiver hospedado no YouTube, especifique as marcações de tempo e os rótulos exatos na descrição do vídeo no YouTube. Veja as práticas recomendadas para incluir marcações de tempo nas descrições do YouTube. Esse recurso está disponível em todos os idiomas em que é possível acessar a Pesquisa Google. Se você quiser ativar os capítulos de vídeo no YouTube, siga estas diretrizes adicionais.

Para desativar completamente o recurso Momentos importantes e impedir que o Google tente mostrar automaticamente esses pontos do seu vídeo, use a tag nosnippet meta.

Vídeo com momentos importantes nos resultados da pesquisa

Como adicionar dados estruturados

Os dados estruturados são um formato padronizado para fornecer informações sobre uma página e classificar o conteúdo dela. Caso você não saiba muito sobre o assunto, veja como os dados estruturados funcionam.

Esta é uma visão geral de como criar, testar e lançar dados estruturados.

  1. Adicione as propriedades obrigatórias. Com base no formato que você está usando, saiba onde inserir dados estruturados na página.
  2. Siga as diretrizes.
  3. Valide o código com o Teste de pesquisa aprimorada e corrija os erros críticos. Corrija também os problemas não críticos que possam ser sinalizados na ferramenta, porque eles podem melhorar a qualidade dos dados estruturados, mas isso não é necessário para se qualificar para pesquisas aprimoradas.
  4. Implante algumas páginas que incluam os dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Verifique se a página está acessível ao Google e se não está bloqueada por um arquivo robots.txt, pela tag noindex ou por requisitos de login. Se estiver tudo certo, peça ao Google para rastrear novamente seus URLs.
  5. Para informar o Google sobre mudanças futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.

Exemplos

Resultado de vídeo padrão

Exemplo de resultados padrão da pesquisa de vídeo

Veja um exemplo de um único VideoObject.

JSON-LD

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "name": "Introducing the self-driving bicycle in the Netherlands",
      "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
      "thumbnailUrl": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "uploadDate": "2024-03-31T08:00:00+08:00",
      "duration": "PT1M54S",
      "contentUrl": "https://www.example.com/video/123/file.mp4",
      "embedUrl": "https://www.example.com/embed/123",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 5647018
      },
      "regionsAllowed": ["US", "NL"]
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdados

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Introducing the self-driving bicycle in the Netherlands</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-03-31T08:00:00+08:00" />
  <meta itemprop="duration" content="PT1M54S" />
  <p itemprop="description">This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="5647018" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <link itemprop="embedUrl" href="https://www.example.com/embed/123" />
  <meta itemprop="contentUrl" content="https://www.example.com/video/123/file.mp4" />
  <meta itemprop="regionsAllowed" content="US" />
  <meta itemprop="regionsAllowed" content="NL" />
  <meta itemprop="thumbnailUrl" content="https://example.com/photos/1x1/photo.jpg" />
</body>
</html>

Selo AO VIVO

Exemplo de um vídeo nos resultados da pesquisa com um selo AO VIVO

Veja um exemplo de VideoObject e BroadcastEvent.

JSON-LD

<html>
  <head>
    <title>Bald Eagle at the Park - Livestream</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "contentURL": "https://example.com/bald-eagle-at-the-park.mp4",
      "description": "Bald eagle at the park livestream.",
      "duration": "PT37M14S",
      "embedUrl": "https://example.com/bald-eagle-at-the-park",
      "expires": "2024-10-30T14:37:14+00:00",
      "regionsAllowed": "US",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 4756
      },
      "name": "Bald eagle nest livestream!",
      "thumbnailUrl": "https://example.com/bald-eagle-at-the-park",
      "uploadDate": "2024-10-27T14:00:00+00:00",
      "publication": [
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T14:00:00+00:00",
          "endDate": "2024-10-27T14:37:14+00:00"
        },
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T18:00:00+00:00",
          "endDate": "2024-10-27T18:37:14+00:00"
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdados

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Bald Eagle at the Park - Livestream</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-10-27T14:00:00+00:00" />
  <meta itemprop="duration" content="PT37M14S" />
  <p itemprop="description">Bald eagle at the park livestream.</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="4756" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <link itemprop="embedUrl" href="https://example.com/bald-eagle-at-the-park" />
  <meta itemprop="expires" content="2024-10-30T14:37:14+00:00" />
  <meta itemprop="contentUrl" content="https://example.com/bald-eagle-at-the-park.mp4" />
  <meta itemprop="regionsAllowed" content="US" />
  <meta itemprop="thumbnailUrl" content="https://example.com/bald-eagle-at-the-park" />
  <div itemprop="publication" itemtype="https://schema.org/BroadcastEvent" itemscope>
    <meta itemprop="isLiveBroadcast" content="true" />
    <meta itemprop="startDate" content="2024-10-27T14:00:00+00:00" />
    <meta itemprop="endDate" content="2024-10-27T14:37:14+00:00" />
  </div>
  <div itemprop="publication" itemtype="https://schema.org/BroadcastEvent" itemscope>
    <meta itemprop="isLiveBroadcast" content="true" />
    <meta itemprop="startDate" content="2024-10-27T18:00:00+00:00" />
    <meta itemprop="endDate" content="2024-10-27T18:37:14+00:00" />
  </div>
</body>
</html>

Clip

Exemplo de um vídeo nos resultados da pesquisa com Momentos importantes

Veja um exemplo de VideoObject e Clip.

JSON-LD

<html>
  <head>
    <title>Cat jumps over the fence</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "VideoObject",
      "name": "Cat video",
      "duration": "PT10M",
      "uploadDate": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://www.example.com/cat.jpg",
      "description": "Watch this cat jump over a fence!",
      "contentUrl": "https://www.example.com/cat_video_full.mp4",
      "ineligibleRegion": "US",
      "hasPart": [{
        "@type": "Clip",
        "name": "Cat jumps",
        "startOffset": 30,
        "endOffset": 45,
        "url": "https://www.example.com/example?t=30"
      },
      {
        "@type": "Clip",
        "name": "Cat misses the fence",
        "startOffset": 111,
        "endOffset": 150,
        "url": "https://www.example.com/example?t=111"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdados

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">Cat jumps over the fence</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-07-19" />
  <meta itemprop="duration" content="P10M" />
  <p itemprop="description">Watch this cat jump over a fence!</p>
  <div itemprop="interactionStatistic" itemtype="https://schema.org/InteractionCounter" itemscope>
    <meta itemprop="userInteractionCount" content="5647018" />
    <meta itemprop="interactionType" itemtype="https://schema.org/WatchAction" />
  </div>
  <div itemprop="hasPart" itemtype="https://schema.org/Clip" itemscope>
    <meta itemprop="name" content="Cat jumps" />
    <meta itemprop="startOffset" content="30" />
    <meta itemprop="endOffset" content="45" />
    <meta itemprop="url" content="https://www.example.com/example?t=30" />
  </div>
  <div itemprop="hasPart" itemtype="https://schema.org/Clip" itemscope>
    <meta itemprop="name" content="Cat misses the fence" />
    <meta itemprop="startOffset" content="111" />
    <meta itemprop="endOffset" content="150" />
    <meta itemprop="url" content="https://www.example.com/example?t=111" />
  </div>
  <link itemprop="embedUrl" href="https://www.example.com/embed/123" />
  <meta itemprop="contentUrl" content="https://www.example.com/cat_video_full.mp4" />
  <meta itemprop="ineligibleRegion" content="US" />
  <meta itemprop="thumbnailUrl" content="https://www.example.com/cat.jpg" />
</body>
</html>

SeekToAction

Veja um exemplo de um único VideoObject que inclui as propriedades adicionais necessárias para a marcação SeekToAction.

JSON-LD

<html>
  <head>
    <title>John Smith (@johnsmith123) on VideoApp: My daily workout! #stayingfit</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "potentialAction" : {
        "@type": "SeekToAction",
        "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
        "startOffset-input": "required name=seek_to_second_number"
      },
      "name": "My daily workout!",
      "uploadDate": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://www.example.com/daily-workout.jpg",
      "description": "My daily workout!",
      "embedUrl": "https://example.com/daily-workout"
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdados

<html itemscope itemprop="VideoObject" itemtype="https://schema.org/VideoObject">
<head>
  <title itemprop="name">John Smith (@johnsmith123) on VideoApp: My daily workout! #stayingfit</title>
</head>
<body>
  <meta itemprop="uploadDate" content="2024-07-19" />
  <p itemprop="description">My daily workout!</p>
  <div itemprop="potentialAction" itemtype="https://schema.org/SeekToAction" itemscope>
    <meta itemprop="target" content="https://video.example.com/watch/videoID?t={seek_to_second_number}" />
    <meta itemprop="startOffset-input" content="required name=seek_to_second_number" />
  </div>
  <link itemprop="embedUrl" href="https://example.com/daily-workout" />
  <meta itemprop="thumbnailUrl" content="https://www.example.com/daily-workout.jpg" />
</body>
</html>

Diretrizes

Para que os dados estruturados de vídeo se qualifiquem para uso na Pesquisa Google, siga os Fundamentos da Pesquisa, as diretrizes gerais de dados estruturados e os requisitos de indexação de vídeo.

Além disso, recomendamos que você confira estas diretrizes caso elas se apliquem ao conteúdo do seu vídeo:

Diretrizes do selo AO VIVO

Se você quiser adicionar BroadcastEvent para marcar vídeos de transmissões ao vivo, siga estas diretrizes:

  • Não use linguagem vulgar ou possivelmente ofensiva nos dados estruturados.
  • Para garantir que o Google rastreie seu vídeo de transmissão ao vivo no momento certo, use a API Indexing. Chame a API para os seguintes eventos:
    • Quando o vídeo for transmitido ao vivo.
    • Quando o vídeo parar de transmitir e a marcação da página for atualizada para indicar a endDate.
    • Sempre que uma mudança acontecer na marcação e o Google precisar ser notificado.

Práticas recomendadas para fazer marcações de tempo no YouTube

Se o vídeo estiver hospedado no YouTube, é possível que a Pesquisa Google ative os Momentos importantes automaticamente com base na descrição do vídeo. Nesse caso, não será necessário fazer as marcações de tempo específicas. No entanto, é possível que você nos informe mais explicitamente sobre os pontos importantes do vídeo. Nós damos preferência a essas informações. O diagrama a seguir mostra como as marcações de tempo e as etiquetas de uma descrição do YouTube aparecem nos resultados da pesquisa:

Um vídeo com marcações de tempo e etiquetas nos resultados da pesquisa
1. Etiqueta: é o título do clipe.
2. Marcação de tempo: é o momento em que um clipe começa.

Tenha em mente as seguintes diretrizes ao formatar marcações de tempo e etiquetas nas descrições do YouTube:

  • Formate a marcação de tempo desta maneira: [hour]:[minute]:[second]. Se não houver hora, não é necessário incluí-la.
  • Especifique a etiqueta e a marcação de tempo na mesma linha.
  • Coloque cada marcação de tempo em uma nova linha na descrição do vídeo.
  • Vincule a marcação de tempo ao ponto especificado no vídeo.
  • Verifique se a etiqueta contém pelo menos uma palavra.
  • Liste as marcações de tempo em ordem cronológica.

Se você quiser ativar os capítulos de vídeo no YouTube, siga estas diretrizes adicionais.

Diretrizes de Clip e SeekToAction

Ao adicionar dados estruturados Clip ou SeekToAction para marcar segmentos de vídeos, siga estas diretrizes:

  • O vídeo precisa conseguir criar links diretos para um ponto que não seja o início no URL dele. Por exemplo, https://www.example.com/example?t=30 inicia o vídeo 30 segundos depois do começo.
  • Dados estruturados VideoObject precisam ser adicionados a uma página em que os usuários consigam assistir o vídeo. Não direcione os usuários a uma página que não exibe o vídeo.
  • A duração total do vídeo precisa ser de no mínimo 30 segundos.
  • O vídeo precisa incluir as propriedades obrigatórias listadas na documentação de dados estruturados VideoObject.
  • Somente para dados estruturados Clip: confira se não há dois clipes no mesmo vídeo definidos na mesma página e que compartilhem um tempo de início.
  • Somente para dados estruturados SeekToAction: o Google precisa conseguir buscar os arquivos de conteúdo em vídeo.

Definições de tipos de dados estruturados

Esta seção descreve os tipos de dados estruturados relacionados a recursos de vídeo da Pesquisa Google. É necessário incluir as propriedades VideoObject obrigatórias para que o conteúdo seja qualificado para uso na Pesquisa Google. Você também pode incluir as propriedades recomendadas para adicionar mais informações sobre o VideoObject, o que pode proporcionar uma melhor experiência do usuário. Além de VideoObject, também é possível adicionar os seguintes tipos de dados para ativar os aprimoramentos de vídeo na Pesquisa Google:

  • BroadcastEvent: marque vídeos de transmissões ao vivo para incluir um selo AO VIVO neles.
  • Clip: marque segmentos importantes do vídeo para ajudar os usuários a navegar rapidamente até pontos específicos dele.
  • SeekToAction: para ativar os Momentos importantes, indique como a estrutura do URL funciona. Assim o Google poderá identificar automaticamente os Momentos importantes e fornecer aos usuários os links desses pontos do vídeo.

VideoObject

A definição completa de VideoObject está disponível em schema.org/VideoObject (em inglês). Se você não incluir as propriedades obrigatórias, talvez o Google não consiga extrair informações sobre o vídeo. Você também pode incluir as propriedades recomendadas para adicionar mais informações sobre o conteúdo, o que pode proporcionar uma melhor experiência do usuário.

Propriedades obrigatórias
name

Text

É o título do vídeo. Use um texto exclusivo na propriedade name. para cada vídeo no site.
thumbnailUrl

URL repetido

É um URL que aponta para o arquivo de imagem de miniatura exclusivo do vídeo. Siga as diretrizes para imagens de miniaturas.
uploadDate

DateTime

É a data e a hora em que o vídeo foi publicado pela primeira vez, no formato ISO 8601. 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.
Propriedades recomendadas
contentUrl

URL

Um URL que aponta para os bytes de conteúdo reais do arquivo de vídeo, em um dos tipos de arquivos compatíveis. Não crie um link para a página em que o vídeo está localizado. Ele precisa ser o URL dos bytes de conteúdo real do arquivo de vídeo.

"contentUrl": "https://www.example.com/video/123/file.mp4"

Siga nossas práticas recomendadas de vídeo.
description

Text

É a descrição do vídeo. Use um texto exclusivo na propriedade description para cada vídeo no site. As tags HTML são ignoradas.
duration

Duration

É a duração do vídeo, no formato ISO 8601. Por exemplo, PT00H30M5S representa uma duração de "30 minutos e 5 segundos".
embedUrl

URL

É um URL que aponta para um player do vídeo específico. Não crie um link para a página em que o vídeo está localizado. Ele precisa ser o URL do próprio player de vídeo. Geralmente, essa é a informação no atributo src de um elemento <embed>.

"embedUrl": "https://www.example.com/embed/123"

Siga nossas práticas recomendadas de vídeo.
expires DateTime

Se aplicável, a data e a hora finais em que o vídeo vai estar disponível, no formato ISO 8601. Não forneça essa informação se o vídeo não for expirar. 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.
hasPart

Se o vídeo tiver segmentos importantes, aninhe as propriedades Clip obrigatórias em seu VideoObject. Exemplo:

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "hasPart": {
    "@type": "Clip",
    "name": "Cat jumps",
    "startOffset": 30,
    "url": "https://www.example.com/example?t=30"
  }
}
</script>
ineligibleRegion

Place

É a região em que o vídeo não é permitido, se aplicável. Se não especificado, o Google vai presumir que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166-1 de duas ou três letras. Para diversos valores, use vários códigos de país (por exemplo, uma matriz JSON-LD ou várias tags meta em microdados).
interactionStatistic

InteractionCounter

É o número de visualizações do vídeo. Exemplo:

"interactionStatistic":
  {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "WatchAction" },
    "userInteractionCount": 12345
  }
publication

Se o vídeo estiver sendo transmitido ao vivo e você quiser se qualificar para o selo AO VIVO, aninhe as propriedades BroadcastEvent em VideoObject. Exemplo:

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "publication": {
    "@type": "BroadcastEvent",
    "name": "First scheduled broadcast",
    "isLiveBroadcast": true,
    "startDate": "2018-10-27T14:00:00+00:00",
    "endDate": "2018-10-27T14:37:14+00:00"
  }
}
</script>
regionsAllowed

Place

As regiões em que o vídeo é permitido, se aplicável. Se não especificado, o Google vai presumir que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166-1 de duas ou três letras. Para diversos valores, use vários códigos de país (por exemplo, uma matriz JSON-LD ou várias tags meta em microdados).

BroadcastEvent

Para se qualificar para exibição com um selo AO VIVO, aninhe as seguintes propriedades em VideoObject. Ainda que as propriedades BroadcastEvent não sejam obrigatórias, você precisa incluir as propriedades a seguir para que o vídeo se qualifique para ser exibido com um selo AO VIVO.

A definição completa de BroadcastEvent está disponível em schema.org/BroadcastEvent (em inglês).

Propriedades obrigatórias
publication

BroadcastEvent

Descreve quando o vídeo será transmitido ao vivo. Pode ser uma lista ou uma única instância.
publication.endDate

DateTime

É a hora e a data de quando a transmissão ao vivo termina, ou está prevista para terminar, no formato ISO 8601.

É necessário fornecer endDate quando o vídeo terminar e não estiver mais ativo. Se a endDate esperada for desconhecida antes do início da transmissão ao vivo, recomendamos fornecer uma endDate aproximada.

Se a endDate estiver no passado ou presente, ela indica que a transmissão terminou e não está mais ao vivo. Se a endDate estiver no futuro, ela indica que a transmissão está programada para terminar naquele momento.
publication.isLiveBroadcast

Booleano

Defina como true se o vídeo for, tiver sido ou será transmitido ao vivo.

publication.startDate

DateTime

Hora e data de início ou início previsto da transmissão ao vivo, no formato ISO 8601. Se a startDate estiver no passado ou presente, ela indica que a transmissão começou. Se a startDate estiver no futuro, ela vai indicar que a transmissão está programada para começar naquele momento.

Clip

Para informar ao Google a marcação de tempo e a etiqueta a serem usadas no recurso Momentos importantes, aninhe as seguintes propriedades em VideoObject. Ainda que as propriedades Clip não sejam obrigatórias, é preciso incluir as seguintes propriedades para que o Google exiba as etiquetas e as marcações de tempo especificadas para o vídeo, em vez dos segmentos de vídeo que podem ser exibidos automaticamente.

A definição completa de Clip está disponível em schema.org/Clip (em inglês).

Propriedades obrigatórias
name

Text

É um título que descreve o conteúdo do clipe.
startOffset

Number

É o tempo de início do clipe expresso como o número em segundos depois do início da obra.
url

URL

É um URL que aponta para o tempo de início do clipe.

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.

Por exemplo, o URL a seguir significa que o vídeo começa aos dois minutos:

"url": "https://www.example.com/example?t=120"
Propriedades recomendadas
endOffset

Number

É o tempo de término do clipe exibido como o número em segundos depois do início da obra.

SeekToAction

Se quiser informar ao Google como sua estrutura de URL funciona, para que ele possa exibir Momentos importantes identificados automaticamente no vídeo, aninhe as seguintes propriedades em VideoObject. Ainda que as propriedades SeekToAction não sejam obrigatórias, você precisa incluir as propriedades a seguir para que o Google entenda como funciona a estrutura do URL e possa fornecer aos usuários links de um ponto do vídeo.

A definição completa de SeekToAction está disponível em schema.org/SeekToAction (em inglês).

Propriedades obrigatórias
potentialAction

SeekToAction

Indica uma possível ação. Inclui as seguintes propriedades aninhadas:

Exemplo:

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "potentialAction" : {
    "@type": "SeekToAction",
    "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
    "startOffset-input": "required name=seek_to_second_number"
  }
}
potentialAction.startOffset-input

Text

É a string do marcador que o Google identificará como a estrutura de marcação de tempo e substituirá pelo número de segundos para pular. Use o seguinte valor:

"startOffset-input": "required name=seek_to_second_number"

startOffset-input é uma propriedade com anotação. Consulte a página Potential Actions para mais informações.

potentialAction.target

EntryPoint

É o URL da página que contém este VideoObject, incluindo um marcador na estrutura do URL que indica onde o Google pode inserir o número de segundos para pular no vídeo. É assim que o Google entende a estrutura do URL e como você formata as marcações de tempo. Substitua a parte da marcação de tempo do URL pela seguinte string de marcador:

{seek_to_second_number}

Por exemplo, substitua a parte da marcação de tempo do URL: 

"target": "https://video.example.com/watch/videoID?t=30"

Agora a marcação de tempo tem a seguinte aparência:

"target": "https://video.example.com/watch/videoID?t={seek_to_second_number}"

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:

  1. After deploying structured data for the first time
  2. After releasing new templates or updating your code
  3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:

  1. Fix the invalid items.
  2. Inspect a live URL to check if the issue persists.
  3. Request validation using the status report.

After releasing new templates or updating your code

When you make significant changes to your website, monitor for increases in structured data invalid items.
  • If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
  • If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.

Solução de problemas

Se você tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que podem ajudar.