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

A Pesquisa Google é um ponto de entrada para que as pessoas descubram e assistam vídeos. Embora o Google tente entender automaticamente os detalhes do vídeo, é possível marcá-lo com VideoObject para fornecer informações explicitamente, como a descrição, o URL da miniatura, a data do upload e a duração. É possível que os vídeos apareçam nos resultados da Pesquisa Google, nos resultados da pesquisa de vídeos, nas Imagens do Google e no Google Discover.

Uma captura de tela que mostra conteúdo do vídeo nos resultados da Pesquisa Google, na guia de vídeo e no Discover

Com base na marcação do conteúdo, seus vídeos também podem se qualificar para as seguintes melhorias:

Melhorias nos vídeos

Selo AO VIVO: marque seu 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

Atividades em casa: ajude as pessoas a encontrar atividades para fazer em casa. Quando as pessoas pesquisam atividades para fazer em casa, vídeos e eventos on-line aparecem em uma pesquisa aprimorada imersiva. Ao adicionar dados estruturados Video, seus vídeos talvez já estejam qualificados para essa pesquisa aprimorada, sem necessidade de outras etapas.

Para mais informações sobre a disponibilidade de recursos, diretrizes e exemplos, consulte Atividades em casa.

 Atividades em casa 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 seus 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 hospedado na sua página da Web, 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 fornecer aos usuários esses pontos do vídeo. No momento, 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. Nosso objetivo é ampliar o recurso para mais idiomas ao longo do tempo. Mesmo nos idiomas disponíveis, nem todos os vídeos terão Momentos importantes identificados, mas pretendemos melhorar isso com o tempo.
  • Se o vídeo estiver hospedado no YouTube, especifique as marcações de tempo e os marcadores 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
Carrossel do host de vídeo (acesso limitado): adicione dados estruturados ItemList para que os usuários explorem as páginas da sua galeria de vídeos. >No momento, esse recurso está limitado a um pequeno grupo de empresas. É possível que a Pesquisa Google exiba automaticamente um carrossel do host do seu site sem que seja necessário adicionar dados estruturados ItemList.

Vídeos educacionais: ajude alunos e professores a encontrar seus vídeos educativos adicionando dados estruturados relacionados a eles. Para mais informações sobre disponibilidade de recursos, diretrizes e exemplos, veja a documentação de vídeos educacionais.

 Vídeos educacionais 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

Pesquisa aprimorada padrão de vídeo

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,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>

Veja um exemplo de dados estruturados VideoObject e ItemList. Este recurso está atualmente limitado a um pequeno grupo de empresas.

JSON-LD

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "VideoObject",
          "position": 1,
          "name": "Introducing the self-driving bicycle in the Netherlands",
          "url": "https://www.example.com/video/self-driving-bicycle",
          "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://www.example.com/video/self-driving-bicycle/1x1/photo.jpg",
            "https://www.example.com/video/self-driving-bicycle/4x3/photo.jpg",
            "https://www.example.com/video/self-driving-bicycle/16x9/photo.jpg"
          ],
          "uploadDate": "2024-03-31T08:00:00+08:00",
          "duration": "PT1M54S",
          "contentUrl": "https://www.example.com/video/self-driving-bicycle/file.mp4",
          "embedUrl": "https://www.example.com/embed/self-driving-bicycle",
          "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": { "@type": "WatchAction" },
            "userInteractionCount": 5647018
          }
        },
        {
          "@type": "VideoObject",
          "position": 2,
          "name": "How to tie a tie",
          "url": "https://www.example.com/video/how-to-tie-a-tie",
          "description": "How to tie a four-in-hand knot.",
          "thumbnailUrl": [
            "https://www.example.com/video/how-to-tie-a-tie/1x1/photo.jpg",
            "https://www.example.com/video/how-to-tie-a-tie/4x3/photo.jpg",
            "https://www.example.com/video/how-to-tie-a-tie/16x9/photo.jpg"
          ],
          "uploadDate": "2024-02-28T08:00:00+08:00",
          "duration": "PT5M01S",
          "contentUrl": "https://www.example.com/video/how-to-tie-a-tie/file.mp4",
          "embedUrl": "https://www.example.com/embed/how-to-tie-a-tie",
          "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": { "@type": "WatchAction" },
            "userInteractionCount": 102111
          }
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdados

<div>
      <div itemprop="video" itemscope itemtype="https://schema.org/VideoObject">
        <!-- Thumbnail -->
        <a href="https://example.com/videos/self-driving-bicycle"
           title="Introducing the self-driving bicycle in the Netherlands">
          <img src="https://example.com/videos/self-driving-bicycle/thumbnail.jpg"
               alt="Introducing the self-driving bicycle in the Netherlands"
               title="Introducing the self-driving bicycle in the Netherlands"
               itemprop="thumbnailUrl">
        </a>
        <!-- URL, name, and description -->
        <h1>
          <a itemprop="contentUrl" href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
            <span itemprop="name">Introducing the self-driving bicycle in the Netherlands</span>
          </a>
        </h1>
        <a href="https://example.com/videos/self-driving-bicycle"
             title="Introducing the self-driving bicycle in the Netherlands">
          <div 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.
          "</div>
        </a>
        <!-- Other metadata -->
        <meta itemprop="duration" content="PT1M54S" />
        <meta itemprop="uploadDate" content="2024-03-31T08:00:00+08:00" />
        <span itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
        	<span itemprop="interactionType" itemscope itemtype="https://schema.org/WatchAction"></span>
        	<meta itemprop="userInteractionCount" content="5647018" />
        </span>
      </div>

      <div itemprop="video" itemscope itemtype="https://schema.org/VideoObject">
        <!-- Thumbnail -->
        <a href="https://example.com/videos/how-to-tie-a-tie"
           title="How to tie a tie">
          <img src="https://example.com/videos/how-to-tie-a-tie/thumbnail.jpg"
               alt="How to tie a tie"
               title="How to tie a tie"
               itemprop="thumbnailUrl">
        </a>
        <!-- URL, name, and description -->
        <h1>
          <a itemprop="contentUrl" href="https://example.com/videos/how-to-tie-a-tie"
             title="Tie a Tie">
            <span itemprop="name">Tie a Tie</span>
          </a>
        </h1>
        <a href="https://example.com/videos/how-to-tie-a-tie"
             title="Tie a Tie">
          <div itemprop="description">How to tie a four-in-hand knot.</div>
        </a>
        <!-- Other metadata -->
        <meta itemprop="duration" content="PT5M01S" />
        <meta itemprop="uploadDate" content="2024-01-05T08:00:00+08:00" />
        <span itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
        	<span itemprop="interactionType" itemscope itemtype="https://schema.org/WatchAction"></span>
        	<meta itemprop="userInteractionCount" content="102111" />
        </span>
      </div>
    </div>

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",
      "regionsAllowed": "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="regionsAllowed" 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 ajudar o Google a entender melhor seu vídeo, siga estas diretrizes:

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 dos 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 seu conteúdo seja qualificado para exibição como uma pesquisa aprimorada. 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. 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.
  • ItemList: marque as páginas com uma lista de vídeos para ativar um carrossel do host de vídeos.
  • Clip: marque manualmente 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 vai poder identificar automaticamente os Momentos importantes e fornecer aos usuários os links desses pontos do vídeo.
  • Vídeos educacionais: ajude alunos e professores a encontrar seus vídeos educacionais adicionando dados estruturados relacionados a eles.

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 e oferecer uma melhor experiência do usuário.

Propriedades obrigatórias
name

Text

É o título do vídeo.
thumbnailUrl

URL repetido

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

Date

É a data em que o vídeo foi publicado pela primeira vez, no formato ISO 8601.
Propriedades recomendadas
contentUrl

URL

É um URL que aponta para o verdadeiro arquivo de mídia do vídeo em um dos formatos de codificação compatíveis. Não crie um link para a página em que o vídeo está localizado. Ele precisa ser o URL do próprio arquivo de mídia 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. 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 uma tag <embed>.

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

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

Date

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

São as regiões onde o vídeo é permitido. Se não especificado, o Google presumirá que ele é permitido em qualquer lugar. Especifique os países no formato ISO 3166. Se tiver vários valores, use um espaço ou uma vírgula como delimitador.

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 indicará que a transmissão está programada para começar naquele momento.

ItemList (acesso limitado)

Para ajudar o Google a entender melhor as páginas da galeria de vídeos, adicione as propriedades ItemList seguintes, além de propriedades VideoObject. Para saber mais sobre carrosséis, consulte Carrossel.

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

Propriedades obrigatórias
itemListElement

ListItem

Anotação para uma única página de itens. Cada elemento ListItem precisa incluir propriedades VideoObject e ListItem.
ListItem.position

Integer

É a posição ordinal da página de itens na lista. Exemplo:

"itemListElement": [
  {
    "@type": "VideoObject",
    "position": 1,
    ... other VideoObject properties ...
  }, {
    "@type": "VideoObject",
    "position": 2,
    ... other VideoObject properties ...
  }
]
ListItem.url

URL

É o URL canônico da página de itens. Cada item precisa ter um URL exclusivo.

Clip

Para informar manualmente 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}"

Monitorar pesquisas aprimoradas com o Search Console

O Search Console é uma ferramenta que ajuda você a monitorar o desempenho das suas páginas na Pesquisa Google. Não é preciso se inscrever na plataforma para ser incluído nos resultados da Pesquisa Google, mas isso pode ajudar você a entender e melhorar como vemos seu site. Recomendamos verificar o Search Console nos seguintes casos:

  1. Depois de implantar os dados estruturados pela primeira vez
  2. Depois de lançar novos modelos ou atualizar o código
  3. Análise periódica do tráfego

Depois de implantar os dados estruturados pela primeira vez

Depois que o Google indexar as páginas, procure problemas com o relatório de status da pesquisa aprimorada relevante. Em condições ideais, vai haver um aumento de itens válidos e nenhum aumento de itens inválidos. Se você encontrar problemas nos dados estruturados, faça o seguinte:

  1. Corrija os itens inválidos.
  2. Inspecione um URL ativo para verificar se o problema persiste.
  3. Solicite a validação com o relatório de status.

Depois de lançar novos modelos ou atualizar o código

Ao fazer mudanças significativas no site, monitore aumentos nos itens inválidos de dados estruturados.
  • Caso você perceba um aumento nos itens inválidos, talvez tenha lançado um novo modelo que não funcione ou o site esteja interagindo com o modelo existente de uma maneira nova e incorreta.
  • Caso você veja uma diminuição nos itens válidos (não correspondidos por um aumento nos itens inválidos), talvez não esteja mais incorporando os dados estruturados às páginas. Use a Ferramenta de inspeção de URL para saber o que está causando o problema.

Análise periódica do tráfego

Analise o tráfego da Pesquisa Google com o Relatório de desempenho. Os dados vão mostrar com que frequência sua página aparece como aprimorada na Pesquisa, com que frequência os usuários clicam nela e qual é a posição média dela nos resultados. Também é possível extrair automaticamente esses resultados com a API Search Console.

Solução de problemas

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